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FOREWORD. 

Brad Templeton showed me his first POWER system In 1979. It was an 
early version, but had many of the features of the present package. I 
quickly became addicted to Its use ... Basic programs came together more 
easily with POWER In place. 

I was using POWER long before ft became commercially available; this 
made me a logical candidate to write the documentation. 

POWER has been available for PET/CBM computers for some time. Now 
there's POWER 64 for the Commodore 64 computer. 

This manual Is written to help you make good use of the wide range of 
features available In the POWER 64 package. 


Jim Butterfield, 
Toronto. 
February, 1983. 
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Is Introduction 


POWER 64 


I. INTRODUCTION TO POWER 64. 

Welcome to the POWER 64 system! POWER 64 adds new capability to your 
Commodore 64 computer. With POWER 64, you'll write programs better, 
faster and more easily. Your Basic programs will test and debug more 
conveniently; and changes and updates become a snap. 

POWER 64 makes Commodore 64 Basic programs easy to use and change. It 
does this with special 'Instant action' keyboard features and with 
additional commands. The 64 Is a friendly machine; Its screen editing 
makes It easy to use. With POWER 64, the friendship will ripen Into... 
well, closer friendship. 

The first thing you'll notice about the POWER 64 system Is Its cursor 
action. Not only do cursor movements repeat automatically; they seem 
to reach beyond the screen to dig out program lines above and below the 
screen Itself. 

Next, you'll spot the 'Instant keywords'. Tapping a single (shifted) 
key can produce a complete Basic keyword to speed your programming and 
perhaps improve your spelling. More: you can define a single key to 
mean anyth I ng you like: a comp I ete line of Bas I c, If you like. Even 
this Isn't the limit of what you can do with a single key: one key can 
Invoke a whole subroutine of activity! 


Page 1 



POWER 64 Manua 


Is Introduction 


A whole family of special commands are featured In the POWER 64 system. 
They will be described In detail later In this manual. For the moment, 
here's a quick summary, with optional Information enclosed In 
parentheses: 


AUTO (line no.)(,Increment) 

which gives automatic line prompting. 

DEL line-range 

which deletes a range of Basic program lines. 

DUMP 

which dumps the values of active Basic variables, so that you 
can see them and change them. 

FIX and PTR 

which restore Basic pointers. 

OFF 

which disables POWER 64. 

RENUM {Increment)(,new start)(,IIne-range) 
which renumbers all or part of a Baste program. 

SEL R, I, K or P + or - 

which turns on or off several 'Instant key' activities. 

TRACE (LIST, #, *, #* or LIST*) 

which engages a powerful Trace facility for testing Basic 
programs. 


[ 

L 

[ 

[ 

C 

[ 

[ 

[ 

[i 


Page 2 



POWER 64 Manual 


1: Introduction 


WHY 

which helps to Identify the cause of a Basic error. 

EXEC file-number 

which assigns control to a tape or disk file, allowing powerful 
features such as a Basic program merge. 

/..pattern.. (/Ifne-range) 

which searches for certain words or phrases In your Basic 
program. 

S/..pattern../..substitute.. (/IIne-range) 

which substitutes words or phrases with other Information. 

TEST 

which creates a special area to work with Basic programs 
different from the one being worked In. 

BACK 

Which restores the original Basic program after a TEST. 
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2. STARTING UP. 

** NOTE: How you start POWER 64 depends on whether you have a cartridge 
version or disk version. Below you'll find out about loading the disk 
verslon. 

Before POWER 64 can do anything, you have to load It from disk and 
activate It. Until you put POWER 64 In gear, your computer will be 
precisely the same as always. Each time you switch the computer off, 
POWER 64 deactivates. When you switch on again, you'll need to call In 
the POWER 64 system using the method shown below. 

First you must place your POWER 64 system disk Into your disk drive. 
You load POWER 64 just like any other Basic program you may have run. 
First, turn your computer and disk drive on. Then put the POWER 64 
disk, face up. Into the disk drive and close the door as described In 
your dIsk manuaI. 

The cursor should be flashing on the screen of your 64 as usual. Type 
the command: 

LOAD"POWER",8 

...followed by the RETURN key. This will load In a small program that 
will help bring POWER 64 Into your machine. While It loads, you should 
see the strings SEARCHING FOR POWER and LOAOING appear on the screen. 
After a few seconds, the 64's cursor should appear again. If any of 
this does not happen, you should go to Appendix B, which talks about 
troubIeshootlng. 

Once this program has loaded, you should type RUN and press the RETURN 
key. POWER 64 Itself will now begin loading Into your machtne. When It 
Is finished doing so, the POWER 64 system advises you that It Is now 
enabled by printing the copyright message. Then the word "READY." will 
print and the cursor will flash, awaiting your next command. 
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This sequence may seem quite ordinary to you, but In the 64 It opens up 
a whole new world - the world of programmer POWER. 

If the copyright statement does not print, or your computer does not 
print READY and flash the cursor, you have a problem. This Is unusual; 
refer to Appendix B for troubleshooting procedures. 

Now you're ready to go; the features of POWER 64 are literally at your 
fingertips. 

Most users start up the POWER 64 system as soon as they turn on their 
computers, and leave It In for the entire session. If you wish to 
disconnect POWER 64, however, you can simply type OFF followed by a 
Return characters this will kill the POWER 64 features and restore you 
to normal Commodore 64 activity. 

Keep In mind that POWER 64 Is most useful when you are developing and 
testing new programs. Programs written using POWER 64 will stt11 run on 
any similar computer, even ones not equipped with POWER 64. If you 
switch on with the Intention of using your computer only for a program 
run - not testing or writing programs - you won't need to engage the 
POWER 64 system. You may wait and call It In later when you need Its 
features. 

Reminder 


Every time you power up, remember to POWER up by loading from your 
POWER 64 disk. 
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3. THE POWER 64 CURSOR. 

A Note about this Manual. 


This guide Is meant to be used along with your Commodore 64 computer. 
Turn on your machine and try things out as you read. POWER 64's 
features are quite natural, and you'll learn them best by using them. 

So If you're not sitting by your computer with the power on, stop 
reading this manual and go there. 

It you don't have a Commodore 64 computer, buy one Immediately. Then 
put your POWER 64 disk Into It and engage POWER 64 by loading and 
RUNnlng It. We will get to MOREPOWER In Appendix "A". Now read on. 

Scro111ng Power. 

First we'll describe a dramatic feature of POWER 64 which Is more than 
just useful. It wt 11 amaze and mystify your friends - not to mention 
making them green wtth envy until they, too, get a POWER 64 system. If 
you've used your 64 before, you know you can move the cursor quickly 
around the screen by holding down the cursor movement keys. Now, wtth 
POWER 64, your cursor will seem to reach out beyond the top and bottom 
of the screen! 

Load any Basic program, from disk or tape; or type In a brief program on 
the keyboard. It doesn't need to be a working program, since we plan 
only to list It at this time, but It would be nice to have a program of 
thirty or more lines, so that we have more than a screenful. If you 
don't happen to have a program with you at the moment, you could type In 
the one from Appendix G. 
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List the program In the usual way with the LIST command. The first 
lines of the program will disappear off the top of the screen, and 
you'll end up with the last twenty lines or so of the program showing on 
the screen. 

It Is one of Murphy's axioms of programming that the particular line 
that you happen to want to look at will have vanished from the screen. 
A related law says that any attempt to list selectively, say 
LIST 200-300, will probably get the wrong lines anyway. POWER 64 to the 
rescue! 

After you've done a LIST, the cursor will be blinking at you from the 
bottom of the screen. Move It up to the top using the cursor-up key and 
POWER 64's automatic repeat. You're moving toward the earlier lines of 
your program. Now - KEEP GOING. When the cursor reaches the top of the 
screen, the cursor-up key will cause earlier lines of your program to 
appear. Eventually, If you keep holding down the cursor-up key, you'll 
reach the start of your program. And of course, you can stop anywhere 
along the way. 

If you've been moving up to look at earlier parts of your program, later 
Itnes will have disappeared off the bottom of the screen, of course. 
You can get them back easily: just move the cursor down to the bottom 
of the screen with the cursor-down key, and the later lines will scroll 
Into sight. 

It's handy. It's powerful, and It's quite dramatic. Sit In front of 
your 64 and scroll programs up and down to your heart's content. It's 
rather fun and probably more educattonal than watching television. Try 
to avoid humming, "01' Man POWER, he jus' keeps scrollin' along... 
It's considered poor taste unless you do It very quietly. 
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A quick technical note: POWER 64 knows which new Itne to write to the 
screen by looking at the screen - top or bottom as the case may be - for 
the previous line number. This means, for example, that If you type a 
new line for your program, say line 125, near the bottom of the screen 
and then perform cursor-down, you'll get the lines following 125. 
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4. THE INSTANT ACTION KEYBOARD, PART I: INSTANT KEYWORDS. 

POWER 64 Is so designed that a single key can do a lot of work. We'll 
try out the simplest "Instant action" feature first - the Instant 
keywords. 

Hold down the Shift key and press the letter L on the keyboard. 
Surprise! The word LIST appears. Release the Shift key and press 
RETURN and the program you have In memory will be listed. 

The keyboard Is set so that a single shifted key prints an entire Basic 
keyword. Shifted F, for example, causes the word FOR to print; shifted 
N produces NEXT, and so on. Hold down the shift key and practice speed 
typing. You'll find an appendix with a complete list of what keywords 
come from each key, and you'll learn to use the common ones quite 
quickly. Sometimes, the CONTROL or COMMODORE KEY versions of a letter 
have been defined In addition to the shift version, and that's all In 
the table. In the meantime, explore the keyboard. 

It's Important to understand that the Instant key action produces output 
to the screen only. When you type shifted L, the word LIST appears on 
the screen - nothing more. That's all you need, however: when you 
press RETURN your computer will take Its Instructions from the screen, 
and do the LIST you want. Similarly, If you're typing In a program you 
might enter the line number and then press shifted F to generate the 
keyword FOR ... keep typing to complete the line and you'll have saved a 
little time and effort. The FOR will be saved as part of your program 
line. 

POWER 64 Is smart enough to recognize that you sometimes want to type 
graphics or shifted alphabetic characters. If you enter a line like 
PRINT "(character)" where the character Is graphic or shifted, POWER 64 
will know not to change It Into a keyword; you'll get the graphic you 
lntend. 
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Check over the list of Instant keywords In Appendix F, or experiment,, 
You'll find keywords at your fingertips; the longer keywords will be 
aspeeTa I Iy convenlent. 


The Instant Action keywords are activated when you first fire up 
PQSiSR 64^. re by chance you wish to turn them off - perhaps you like to 
tiratk^lspafFIng. ml Stakes - you can easily disconnect this feature. Type 


SEL K- 


Se4ect - we'll meet thts command 
and - stands for turn off. 


again; K stands for 



YdsS&onT powers: 
feature off. 


If SEL K- Is the command that turns the 
what command would you use to turn It back 


SEL K+ 


coStaand to make Instant keywords return tnto being, you're 
bbSjbl&fefy? Ft ghrtv and you may paste a small gold star at the top of this 
0*v -ao-:f by the way. If this happens to be somebody else Vs 
are reading, and there Is no gold star pasted at the 
»bWSer that the rightful owner got this question wrong, 
stars at the time. Either way, don't feel too 
h* has a POWER 64 system and you don't. Yet. 




"dre just a small part of Instant keyboard features. 
»r you •* Ft I earn:- how to define your own keywords and phrases and cal I 
up with a. single key. But that comes later. 


Page 10 




POWER 64 Manual 


5: AUTO/DEL/RENUM 


5. FIRST POWER 64 COMMANDS: AUTO, DEL, and RENUM. 

In this chapter, we'll talk about several commands for helping you with 
Basic programming. 

AUTO gives automatic line numbering, which helps keep track of program 
line numbers and saves you some typing. DEL stands for Delete; It will 
help you get rid of a group of unwanted lines. And RENUM Is the super 
deluxe Basic line renumbering package that comes with your POWER 64 
system. 

AUTO - Automatic Line Numbering. 


If you type In the phrase: 

AUTO 100,10 

...the computer will prompt you with line numbers so that you can Input 
Basic statements; It will start at line 100 and each subsequent prompted 
line will be 10 higher than the last. You may pick any starting line 
number you like; the Increment (the second value) should not be greater 
than 255. 

You may continue typing Baste program lines and the computer will keep 
on prompting for new ones. Eventually most programmers finish their 
coding and don't want to type any more lines. The computer will keep 
prompting for the next line, however. If you are the cooperative type 
you may want to be helpful and think up some more lines to type In; but 
the computer just keeps prompting for more, and eventually even the most 
helpful of programmers will want to stop somewhere. To stop automatic 
line prompting, type RETURN. A line number followed by RETURN usually 
deletes the line In question; .but this won't happen with automatic line 
numbering. If your last prompted line number was 450 and you press 
RETURN, automatic Itne prompting will cease but you will not remove line 
450 from the program. If It's there. 
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If you like, you may type In just the starting line number: for 
example, AUTO 200 will start numbering from 200.. The step size wtll be 
whatever you used last, or a value of 10 If you haven't previously set 
the step. 

When you type AUTO without any numbers, a handy thing happens. POWER 64 
wtll automatically find the end of the Baste program and start adding 
new lines there. For example. If your program went to line 640, 
commanding AUTO could produce a prompt for new line 650. Very 
convenient. Try It. 

DEL - Delete a Range of Lines. 

If you have a group of lines you wish to remove from a Basic program, 
use the DEL command to delete them. Type the line number range behind 
the DEL: 

DEL 500-600 

...removes lines 500 to 600, Inclusive. You may use the same type of 
line range Indication as with a LIST command: DEL 900- removes all 
lines from 900 up, and DEL -125 removes all lines up to 125. If you 
really must know, DEL - removes all lines; but the command NEW would do 
the job just as well. 

RENUM - Renumber Basic Lines. 


This ts a deluxe renumbering package that takes up to four (count 'em) 
parameters. It's easiest to show how they work with examples: 

RENUM by Itself renumbers the whole program In steps of 10, starting at 
line 10. 

RENUM 5 renumbers the whole program In steps of 5, starting at line 5. 
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RENUM 5,30 renumbers the whole program tn steps of 5, starting at line 
30. 

RENUM 5,30,100-200 renumbers lines 100 to 200 of the original program 
Into a group of lines In steps of 5, starting at line 30 .. If possible. 
If the new numbers won't fit properly within the program, a warning 
message will be Issued and renumbering will not take place. 

Renumbering will correct all line references within the program to fit 
the new line numbers. Everything Is fixed up nicely. 

Using RENUM for Renumbering. 

If you have used other Baste renumbering systems, you may be puzzled at 
first by the seemingly unusual way that POWER 64 asks you to Input the 
numbers: Increment first, then starting line number, and finally the 

range to be renumbered. You'll get used to It quickly and will soon 
discover that It makes sense. You need put tn only the numbers you 
want; the missing values will be handled naturally and correctly. 

A few examples will show how neatly POWER 64 does renumbering jobs. 

a) G. Whtzz wants his program to be neatly numbered. He types RENUM 
and the program ts renumbered starting at line 10 In steps of 10. 

b) L. E. Fant wants her program to be numbered very compactly. She 
types RENUM 1 and her program now starts at line 1 and goes In 
steps of 1. 

c) P. Nutt Is worktng on his program and thinks he'll need to add new 
coding at the beginning and lines here and there within the 
program. He types RENUM 10,200 so that his program starts at 200 
and goes In steps of 10. 
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d) X. Plea+Ive wants to add 30 lines of data statements between lines 
360 and 370 of his existing program. He types RENUM 10,900,370- 
whlch causes lines from 370 to move up to 900 and beyond. In the 
meantime, lines below 370 will have their numbers unchanged so 
that there will be a gap In the line numbers, leaving plenty of 
room for the new lines. 

e) Y. Pout likes her subroutines to start at line 1000 for neatness; 
at the moment, they start at line 743. She types RENUM 
10,1000,743- and It's done. 

f) 0• Cumber has coding from 500 to almost 700 which he wants to make 
neater. There's room for a step size of 5 between lines, so he 
types RENUM 5,500,500-699 and trims It up. It didn't matter that 
no line was numbered 699: POWER 64 caught all the lines Involved. 
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6. FINDING AND CHANGING TEXT. 

It's easy to find or change parts of your program with the POWER 64 
system. For example, suppose you want to find every subroutine call In 
your program. Just type: 

/GOSUB/ 

...and the POWER 64 system will list every line containing the command 
GOSUB. Easy, Isn't tt? 

Changing your program Isn't much harder. If you have a variable called 
T2, and you decide to change It to X2 everywhere In the program, you 
would type: 

S/T2/X2/ 

...and the job Is done. You'll also get a listing of every line that 
has been changed. By the way, the S stands for "Substitute". 

Either of the above commands can be performed on the entire program, or 
on a specific range of Itnes. You could type, for example: 

/GOSUB/ 100-200 
S/T2/X2/ 200- 

There's much more to be learned about effective use of the find (/) and 
substttue (S/) commands: but even the above simple uses are very 
powerful and easy to use. Experiment a Itttle. You'll find nice 
touches; for example, when a pattern Is found more than once In a 
program line, the line will print only once. 
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Search Patterns. 


Searching for the pattern GOSUB will give you all the occurences of the 
GOSUB instruction tn your program. But If you search for the letter G, 
you won't get GOSUB - or GOTO, for that matter. 

This Is because Basic keywords are stored within your computer In an 
unusual way. Commands like PRINT', GOSUB, and FOR, and other words like 
RND, STEP and THEN are stored as "tokens" - not as alphabetic 
characters. When you ask the POWER 64 system to search for GOSUB, It 
knows to look for the GOSUB token. When you ask to search for the 
letter G, it will search for G as requested, and will Ignore the GOSUB 
token. 

This is quite handy. When you are searching for a variable called G, 
you really don't want to see all the GOSUBs, GOTOs, GETs, or LOGs just 
because they happen to be spelled using the letter G. And if you wanted 
to rename variable G and call tt W, you wouldn't appreciate your program 
GETs being changed to WETs. It won't happen, of course. 

Special Search Characters. 

A few characters have been set aside for you to allow special, 
super-powerful searches to take place. Because these characters have 
special purposes, they are called "meta-characters". You can turn off 
the meta-characters, if you wish, and then they will behave like 
ordinary keyboard characters. 

The meta-characters used In the POWER 64 system are: 

. - to match any character 

* - to match any number of characters on the same line 
1 - to match end of Basic line. 
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The apostrophe, or single-quote character (') also has a special 
meaning: It means, "the next character Is not a meta-character". We'll 
give an example of this later. 

Let's put these new characters to work. I want to search for things 
like Fl= or F2= or F3=, etc. My search command wt11 be: 


/F.=/ 


...which we can read as F, "anything", "equals". 

Here's another example. Suppose I want to find all lines where FOR and 
NEXT are on the same line. In that order. I would type: 

/FOR*NEXT/ 

It doesn't matter how many characters are between the FOR and the 
NEXT... POWER 64 will find and report them tf they are on the same line. 
In the same way, you could search for IF ... THEN or any combination. 

A somewhat rarer situation: suppose I wanted to find a line endtng with 
a PRINT command. I could type /PR INTI/ to do the search. The 
end-of-IIne metacharacter, (1) Is more often seen as part of a substttue 
command, but It does work here. 

Suppose I wanted to find all multiplication within a program. I would 
want to search for the asterisk (*) character .. but that's a 
meta-character. No problem: we type /'*/ and the apostrophe signals 
that the asterisk Is a search character, not a meta-character. 
Incidentally, to search tor an apostrophe you would type two of them: 
search for MURPHY'S with /MURPHY"S/. 

You'll also find the apostrophe useful If you want to search for a / 
symbol or for a right square bracket. 
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We've seen that you can turn off a meta-character by using the 
apostrophe. If you don't want to use any meta-characters at all - that 
Is, If you want those characters to behave like any other character = 
you can turn them all off except the apostrophe with the command: 

SEL P- 

...and, of course, restore them with the SEL P+ command. Beginners 
might find It easier to disable meta-characters at first. 

Single Line Searching or Substitution, 

So far, a search or substitution has given us all lines containing the 
search value. What If we want to look at the lines one at a time? 

The trtck Is In the / symbol at the end of your command. If It's there, 
you will search all lines; or If you specify a line range you will 
search all lines within the range. Leave the ending / symbol off, and 
you'll get the next occurence only of the string you're searching for. 
For example, the command: /T1/ gives you all lines containing T1, and 
the command: /T1 gives you the next line only. 

In the same way, the command S/DOG/CAT/ changes DOG to CAT everywhere It 
appears In your program; but the command S/DOG/CAT changes DOG to CAT 
only In the next line that DOG occurs. It's very neat, by the way: the 
line Is completely processed, so that If there are several DOGs on the 
line, they will all become CATs. 

If you are searching for a Itne at a time - that Is, you don't put the / 
symbol at the end of your command - POWER 64 will not stop Its search 
when It reaches the end of your Baste program. Instead, It will go back 
to the beginning and start the search over unless, of course, there's 
nothing to find. 
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Here's a very useful feature: If you want to use the same search string 
as before, you don't need to type It In again! Suppose we are searching 
for CASH: the first time we type /CASH and POWER 64 reports the first 
line containing this string. If we want to look for more CASH we just 
type / and POWER 64 will find It for us. In the same way, we could 
perform substitutions on one line at a time: the command S/WATER/WINE 
changes WATER to WINE on the first line that WATER Is found; 

subsequently, the command S//WINE does the job for each following line. 
Note that we don't need to repeat the search string, WATER. 

Single line searching lets you do something very handy: you can change 
whatever you're searching for part way through the program. For 
example, you can search your program for the FOR keyword; after you've 
found It, you can look for the NEXT that matches It. The general 

procedure Is /FOR followed by /NEXT and If the NEXT you find Isn't the 
matchtng one, you can give / and keep looking. Keep In mind that 
changing the search string doesn't affect the program location at which 
you're searching; In the example above, POWER 64 find the FOR command 
and then searches for NEXT In the lines following. 

Advanced Techniques, Curiosities, and No-Nos. 

Don't forget the power of the meta-characters. When you combine them, 
you can do surprising things. Try your hand at seeing how the following 
work: 

/DOG 1/ ... DOG, only If tt Is at the end of a line 

/00G*1/ ... DOG and everything following It on the line 

/.*/ ... the whole line 


Page 19 


POWER 64 Manual 


6: FINDING/CHANGING TEXT 


Ustng these search strings, we can create: 

S/DOG*I/KENNEL/ 300 ... replace DOG and everything 

behind It with KENNEL In line 300 

Question: can you explain why /./ behaves exactly like a LIST command? 

If you want to search for a / symbol, use the apostrophe: e.g., /*// 
will do the job. It looks puzzling at first glance, but It's not hard 
to see how It works. 

Searching for strings that contain keywords can be tricky. If you are 
looking for MONEY, you may not find It ... until you realize that ON Is 
a keyword. Similarly, trying to find a WORD can be hard because the 
keyword OR Is In there. The easiest way around this kind of problem Is 
to search for the non-keyword parts: NEY or RD will usually do the job 
well. If you're a purist, however, you can do the job by breaking up 
the keywords with an apostrophe: try /MO'NEY/ or /WO'RD/ ... the 
apostrophes are Ignored but they break up the keywords and give you the 
result you want. 

Certain cursor movement symbols can occasionally get confused with 
certain Baste keywords. Example: searching a program for LOAD will 
cause the cl ear-screen cursor character (reverse-heart or reverse-S) to 
be found. If you must search for some of the troublemakers, do the job 
a line at a time, so that you can manually sort but the garbage from the 
trash (or vice versa). 

You can't add to the end of a line by ustng 1 alone as the search 
string. And be very careful about changing a line; If you succeed In 
changing the line Into nothtng at all, Basic will behave rather oddly. 
So don't type things like S/./ unless you like weird programs. By the 
same token (no pun Intended) don't type In S/ by Itself. Un-n!ce things 
tend to happen when you do this. 
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If your Basic program Is large, replacement ac+lvittes can take some 
time; the whole program may need to be moved up or down to make room or 
to close up memory space. Be patient. The STOP key will abort the 
replacement job, of course. If you absolutely can't stand the waft. 
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7. THE INSTANT ACTION KEYBOARD, PART 2: INSTANT PHRASES. 

Earlier we learned how touching a key could produce an entire Basic 
keyword. Now we'll expand that capability so that a key will generate 
any text you 11ke. 

Let's suppose that there's a phrase that you type In frequently. It 
could be anything: a Direct command, a group of program statements that 
you use a lot, or even just a REM statement or a name. Whatever It Is, 
we'll set It up so that It can be called to the screen tnstantly, with 
the touch of a key. 

All that's needed Is to define what we want printed and which key will 
produce It. We do this with a special type of Baste statement. 

Implementing an Instant Phrase. 

Let's take a simple example. Suppose you want your name to appear every 
time you press a shifted N key (N for Name, of course). All you need to 
do Is to type In a special REM (remark) statement at the beginning of 
your program. It would look like this: 

1 rem"N=AIbert Gonk 

...and your name, Albert Gonk, will print as soon as you touch the 
shifted N key. If by any chance your name Is not Albert Gonk, you may 
wish to change the line so that It contains your own name. 

This Is so easy that we can't resist putttng In other lines to help 
along our program. For example: 

2 rem"G=gosub 5000 (a favorite subroutine) 

3 rem"D=for j=1 to 1000 : next j (pause 1 second) 

4 rem"F=for x=1 to (start a loop) 
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...and you can use your Imagination to think up dozens of others. 

The preceding examples show Instant phrases that might be used In 
programs. Don't forget that you may' also generate Instant phrases for 
use as direct commands ... or even as screen controls. Some examples: 

5 rem"S ! =save "@0:program",8 

...will allow you to save a program you are working on quickly and 
easily by typing shifted S followed by Return. You'll find this very 
handy as you'll never mistype a filename again. 

6 rem"P=( down) (down), (down) 

...the Cursor Down key Is pressed to type In this line; you'll get the 
usual reverse-(J character printed. Then whenever you press Shifted P 
the cursor will zip down three lines from Its previous position. 

The Important thing to keep In mind Is that whatever you have placed 
behind the equals sign will be printed whenever you type the appropriate 
shifted key. If you have placed cursor movements there, that's what 
you'll get. If you have placed Basic coding there, or direct commands, 
or even nonsense. It will be neatly repeated back to you when the right 
key Is pressed. You can even define POWER 64 commands that you think 
you will need - RENUM for renumbering, for example - and out It they 
will come when you call for them. For example: 

7 rem"R=renum 10,100 

8 rem"Z=/gosub/ 

Note that the REM lines don't harm the program operation: tf you say 
RUN, Basic will sktp over them as It does to all Itnes that start with 
Remarks. Eventually when you have finished writing and checking out 
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your program you’ll probably want to remove the Instant phrase REM 
statements. They have served their purpose and won't be needed In the 
running program. 

Experiment. Instant phrases are quite easy to set up; a little playing 
around will convince you of their usefulness... even If your name Isn't 
Albert Gonk. 

Be sure to place your phrase-defining lines - the ones with the REM - at 
the beginning of your program. That's the only place that they will 
work. Be careful that you don't put a space after the 'REM' or before 
the '='„ 

Challenge for artistic programmers: write an Instant phrase which draws 
a ptcture on the screen - a square, a face, or a car. Now wander around 
the screen with the power cursor and with a stroke of the Instant key, 
you can draw the picture many times In many places on the screen. 
Picasso POWER! 

A Special Case. 

You may have noted that the foregoing examples have appeared In upper 
and lower case characters. This Is done to make the examples defining 
shifted keys to be more readable. POWER 64 lets you define any key. 
Including normal keys, shifted keys, control keys, "Commodore" keys and 
even the special fat keys on the right hand side of the Commodore 64. 
It Is best not to define the normal letters because once you redefine 
them, they can become rather hard to type. After all, no matter how 
much you like your name, you can get tired of getttng Albert Gonk every 
time you type an "n". The examples thus show capital letters being 
defined. 
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You will want to put your 64 Into lower case mode to go over these 
examples. You can do this by holding down the SHIFT key and the 
Commodore symbol key at the same time. Doing this again will restore 
upper case and graphics character mode. 

Turning off the Instant Phrase feature. 

If you don't want to use Instant phrases the easiest thing do do Is not 
to define any of them. 

In special situations you might want to disconnect the Instant phrase 
feature after you have defined a few Instant phrases. You may do this 
with: 

SEL R- 

...and the feature will be disabled until you reinstate It with SEL R+. 

Note that Instant keywords and Instant phrases are Independent. Each 
feature may be turned on or off separately. Keys will drop their 
Instant keyword Identities when they are used for Instant phrases. 

Tricky bits. 

Clever readers will have noticed that the quotation mark behind the REM 
statement allows cursor movements to be Included In Instant phrases. 
Smart Aleck readers will point out that a second quotation mark will 
disable the cursor movmement feature, so that you can't generate an 
Instant phrase like: 1 rem"H=prtnt "(home)" since the second quotation 
mark turns off the programmed cursor feature. True, but picky. 

You and I will probably never need to do It, but there's always the 
person who wants to have a programmed phrase which ends In one or more 
space characters. It seems hard to do, since spaces are automatically 
stripped from the end of the Basic REM line at the time It Is entered. 
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The easy ways are: (I) use the Shtf+ed Space character, which won't be 
stripped away; or, (II) use a cursor-right character Instead. The 
harder way Is to do a little clever work with the Replace feature; I'll 
leave this as an exercise for the advanced reader. 

Here are some examples for you to work with. They may look funny 
(especially when you list them), but they'll do the job: 

rem"H=prlnt IRVSI" S 

rem"H=prInt IRVSI" S "IRVS OFFP'hello 

rem"H=prInt IRVSI" S "IRVS OFFI"heIlo"!RVSl"qqq 

When you list these examples keep In mind-what was mentioned before 
about the values of SHIFTed characters and Basic keyword tokens. 

Calling Instant phrases from INPUT statements, 

POWER 64 also provides you the ability to call Instant phrases as a 
response to an INPUT during a program run. 

If you want to do this, you must enable the feature with SEL l+. 

In most cases, you'll want to use this spectal Input feature as a 
debugging tool. While you're checking out a program, you can generate 
"canned" tnputs and speed the whole procedure. 

It will work In your final program after debugging Is complete, of 
course. If you choose to use tnstant phrase Input In thts way remember 
that the program will need to run on a system equipped with POWER 64. 
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8. DEBUGGING: WHY, DUMP, and TRACE. 

A computer always does exactly what you tell It to do... not what you 
meant to tell It to do. The mistakes you made are called bugs; getting 
rid of the mistakes Is called debugging. The POWER 64 system has a 
number of aids to help you with this job. 

The most Important debugging tool of all Is you - and especially your 
attitude. Most programmers want their programs to be perfect. But some 
want perfection so badly they turn a blind eye to program faults. Don't 
be like that. Seek out errors; go hunting for them; lay traps for them. 
It's better to find problems early, while the program Is fresh In your 
mind, than to have It pointed out to you months - or years - later. 
While you're doing the debugging, POWER 64 can't do your thinking for 
you but It can give you a lot of help. 

WHY? 

The stmplest type of program error Is signalled to you because the 
computer stops. The computer says something smug like ?SUBSCRIPT OUT OF 
BOUNDS or ?REDIM'D ARRAY or the famous ?SYNTAX ERROR. Although there's 
an attempt to give you some help. It can still be difficult to spot the 
trouble, especially In a long Basic line with multiple statements. 

Type WHY and the POWER 64 system will give you some help. It will list 
the error line, and tndtcate where the computer gave up by highlighting 
that place In the line. Remember that the computer doesn't know what 
you have In mind: If you say something silly like J="3" It has no way of 
knowing whether you meant to say J$ or not; but It will know that there 
Is trouble by the time It reaches the first quotation mark, and will 
stop there. 
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Try writing a program with a lot of little silly mistakes. Run It, and 
when the computer stops on an error, type WHY. You*11 quickly see how 
It works. 

If you stop a program In mid-run by using the RUN/STOP key, you can ask 
to see exactly where the program stopped: just ask WHY. POWER 64 
doesn't give you what I think Is the logical reply to WHY In this case: 
"Because you pressed the RUN/STOP key, turkey!" Instead, It politely 
furnishes you with details of exactly where the program stopped. Very 
courteous. Very handy. 

WHY doesn't work on Direct statements, and It doesn't make much sense to 
say WHY If you didn't get an error message. You'll still be told where 
Basic was working the last time a program ran; but It won't help. And 
If you have the clever sort of mind that would clear a program by typing 
NEW and "then* type WHY, I have only one comment: Why? 

DUMP. 


When a program has stopped running - normally, abnormally, or vta the 
RUN/STOP key - you may ask to see all Its variables by commanding DUMP. 

Out will come all the variables. In the order that they were first used. 
Any variables that haven't been used yet will not be shown. You may 
slow the listing of variables In the usual way, holding down the CONTROL 
key. You may stop the variable listing at any time with the RUN/STOP 
key. Three types of variable will be shown: the usual floating-point 
varlble, such as X; Integer variables, such as X$; and string variables, 
such as X$. In addition to variables, the DUMP command Indicates any 
functions (FN) that have been defined. 

Variables are carefully printed so that you can move the cursor up and 
redeftne any variable's value by typing over the display value and 
pressing RETURN. Thts can be useful If you have stopped a program with 
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the RUN/STOP key and plan to continue the run with the CONT command. 
Sometimes a changed variable value can make It possible to Investigate a 
program's behaviour, or try correcting a problem on the spot. 

DUMP prints only variables and function definitions: It does not print 
arrays. 

Careful analysts of your variables Is a very useful tool for checking 
that a program Is operating properly. Help unload program bugs ... with 
a DUMP. 

The Versatile TRACE Command. 

The Trace feature of POWER 64 lets you watch a Basic program as It Is 
running. It's an excellent way to check out a program: you can watch 
what the program Is doing, and spot where It gets Into trouble. The 
Trace feature Is also a marvellous teaching aid; learners can see 
exactly how Instructions are executed. 

TRACE Is a very rich command; there are many ways you can use It. We'll 
Introduce TRACE with a few examples, but first let's take a quick 
overview. Trace allows you to: 

—step the program through one Instruction at a time; 

--see which line Is executing; 

—optionally see a listing of the line; 

--If desired, see each variable as It Is calculated; 

—choose to watch this Information In-line, or on a 
separate strip at the top of the screen. 


Page 29 


POWER 64 Manual 


8: WHY/DUW/TRACE 


The Trace feature ts engaged by giving the TRACE command, followed by 
one or more option characters. Tracing Is disabled with the command 
TRACE STOP. The option characters are: 

(none) - Full trace: line number, line listing, 
variable; 

t - 01 splay trace data at top of screen, rather 
than In-line; 

LIST - Line number and line listing only 
tf - Line number only 
STOP -Kill trace feature 


Option STOP must be used alone. Option A may be used alone, or with 
option LIST or #. Now let's try a few simple examples. 


Simple Fast Trace. 


Load any Basic program Into your computer, and then type TRACE A#. 
This Is one of the most popular means of quick tracing; It gives line 
numbers at the top of the screen. Now type RUN, and Instantly ... 
nothing seems to happen. 


That's because the Trace feature Is waiting for you to ask for the next 
step. You may choose three types of stepping. They are: 


"f7" key: perform one Baste statement and watt; 


"f5" key: perform Basic statements as long as the 
key Is held down; 


Commodore key: perform Basic statements without Tracing 
as long as the key Is held down. 
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We want to see our Trace happen slowly, so we'll use the "t7" key. This 
Is the fat key on the bottom right of your Commodore 64. Press It, and 
you'll see the line number of the first statement of the program appear 
at the top of the screen. Press It again and a type of "sideways 
scrolling" takes place: you'll get the line numbers of the first two 
statements on the screen. These may be the same. If the first line 
contains more than one statement. 

You're on your own now. Try holding down the Space key for a few 
moments, and watch the line numbers rush by. An INPUT statement will 
stop Tracing momentarily, of course, to allow you to supply the desired 
value. 

Listing the Line. 


Sometimes It Is useful to see the line that Is being executed. You have 
another Trace option that permits this: LIST. If you are sttll Tracing 
a program, break It with the RUN/STOP key; you may restart It later with 
CONT after you have changed the Trace opttons. Now type TRACE LIST * 
to trace with Listing at the top of the screen. Continue your program 
or type RUN. Once again, you may use the "f7" key for single stepping. 
Now, you get a single line number at the top of the screen ... plus the 
IIne Itself. 

If you have lines of coding that contain multiple statements, watch 
carefully when they execute; you'll see an Interesting thing happen. 
You won't always see the whole line; only the part from where you're 
executing a command to the end. This means that a line may first list 
completely as 30 X=5:J=2:M=4. Then, after the X=5 has been executed. It 
will be listed as 30 J=2:M=4. Finally, It will list one last time as 
30 M=4. This Is very handy, since you can always see what part of the 
line Is being executed: It's always the first statement listed. 
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The Btq Trace. 

Now let's go for the whole thing: line number. Baste line listing, and 
variable. Stop the current program If necessary. Now enter TRACE * 
(Trace at top). Start the program again, and use the "f7" key to single 
step. We see the line number; the line listing; and a variable value. 

The variable value Is often useful, but there Is one case where you 
might find It a bit confusing. This could be because you may not 
understand about a special type of computer number called a Boolean 
value. This Is a special number the computer uses to Indicate True or 
False. The value 0 means False and the value -I means true. Now: 
during an IF statement the POWER 64 Trace reports this value to you so 
that you can tell whether or not the IF condition Is true. When your 
program line says IF J=9 .., POWER 64 might display a value of -1. This 
does not mean that J Is equal to minus one; It means that the condition 
J=9 ts True. Similarly, If POWER 64 displayed a value of 0, we know 
that J=9 Is false. If you get the hang of Boolean values, by the way, 
they can be quite handy In your Basic programs. It's quite permissible 
to say B=(J=9) within a Basic program. B will be set to 0 or -1, and 
later you can code IF B THEN... and get the proper action depending on 
whether or not B represents True or False. 

Experiment with the Trace features. You'll find that they are not hard 
to understand, and become more and more useful as you gain experience. 

Tracing In-Line. 

So far, we've been Tracing our program with lines at the top of the 
screen. We don't need to do It that way, of course. If we wish, we may 
allow the Trace Information to go to our normal output location. If the 
Basic program produces output. Trace Information will be mixed In, but 
that's usually not confusing. 
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Tracing at the top of the screen ts more popular, but there are reasons 
why It's attractive to do tt tn-tlne at times. First, you get more 
Trace Information on the screen: you have the whole screen Instead of 
the top three lines, and new lines don't Immediately wipe out the old 
Trace Information. Secondly, you can see how your program Itnes 
Interrelate with the program output data. Thirdly, you can usually send 
your output - Trace and all - to the printer and examine the workings of 
the program at your let sure. 

How do you Trace In line? Simple: just don't say A In your options. 
You would say: TRACE # for line numbers only; TRACE LIST for line 
listings; and just plain TRACE for everything Including variables. 

Once again, don't forget to use your "f7" key to single step, your n f5" 
key to run a continuous Trace, and the Commodore key to run without 
Tracing. 

Try the various Trace modes on a sample program. You'll have no trouble 
seeing how It all works, once you get used to those kinky variables. 

Trace Trivia. 


To send Trace Information to the printer (along with the Baste program 
output) you should use the usual command series of OPEN 4,4:Cf®4. You 
may put this In your program coding or type tt as a Direct statement 
after the program has started running (Break the program, enter the 
command, and CONT to continue). Remember that INPUT, GET, and PRINT# 
statements will cancel the CMD status, and you may need once again to 
break the program and do another CMD 4 followed by CONT In order to 
reinstate everything. It's clumsy, but It's workable. If you choose to 
Trace at the top of screen (TRACE A) the Trace output will never go 
the the printer. 
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When coding a Basic program, you're often allowed to say NEXT alone 
rather than NEXT J or NEXT X. It's good practice to put the variable 
name In anyway: It can help avoid some subtle programming bugs. And If 
that doesn't convince you, try this: NEXT J will print the value of 
variable J tor you during a full TRACE; NEXT alone Is likely to print 
nonsense. So how are you going to code your program NEXT statements? 
With the variable name, I hope. 

You may turn the Trace feature on or off during a program run by the 
simple method of stopping the program, giving the appropriate TRACE 
command, and then continuing with CONT. It Is also possible to have the 
program Itself kick Trace In and out of gear. There's a special SYS 
command to allow you to do this. 

Invoking Trace from a Program. 

Finding the address for this SYS command can be tricky, since your 
verston of POWER 64 could be relocated anywhere In memory. Fortunately, 
the POWER 64 startup program saves the first address of POWER 64 at 
location 704 In memory as what Is known In Black Magic circles as a JuMP 
vector. Those who have been Initiated Into the mysterious powers of hex 
- known more familiarly as machine language - can read the deatalls In 
Appendix D. If not, don't worry; just read on. The Important thing for 
you to know as a mortal Is that the address of the first byte In the 
POWER 64 program can be found with the Baste expression 

PEEK(705)+256*PEEK(706). The special Trace address Is 3 bytes below 
this. 

The command SYSPEEK(705)+256*PEEK(706)-3, - don't forget the comma - 
within a program wt 11 allow .you to turn Tracing on or off or change the 
Trace mode at any time. You would put the Trace options you want behtnd 
the comma; a ful I trace would end with the comma. So 501 
SYSPEEK705)+256*PEEK(706)-3,#♦ would turn on line number tracing at 
the top of the screen when line 501 Is executed, and 571 
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SYSPEEK(705)+256*PEEK(706)-3,STOP wt11 stop the Trace feature when line 
571 Is executed. 

GET statements can be a little tricky to Trace, Provision to cope with 
this Is made In the POWER 64 system. The "f5" key, which Is used for 
fast Tracing, will not normally be seen as Input to a GET statement. 
When the program reaches the GET statement, let go of the "f5" key and 
type In whatever characters would be appropriate at that point In the 
program. When you hold down the "f5" key once again, the characters 
(which have been patiently watttng In the keyboard buffer) will be 
received by the GET statement. 

Summary. 


The debugging commands are rich In power and versatility. Get used to 
the Trace features; they will save you hours of work. Like all POWER 64 
features, these are easy and natural once you get used to them. 
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9. ADVANCED COMMANDS: FIX, PTR, EXEC, SEL, TEST, BACK. 

The commands that we will discuss In this chapter are "advanced". These 
commands solve advanced problems, the type that beginning programmers 
won’t need to worry about. 

The FIX command trims up a Basic program, resetting certain essential 
"pointers" used by Basic. You'll need to FIX a Baste program If you 
have wrecked these pointers by loading In a Machine Language program. 
PTR has a similar use. 

The EXEC commmand has a variety of uses: the most popular one Is to 
merge two Basic programs together Into a single program. When you're 
writing a program, you'll find It handy for slipping In a few Basic 
subroutines you previously wrote, saving the trouble of typing them In 
again. Or you can merge a set of DATA statements Into each of a group 
of related programs so as to Implement new Information such as a revised 
price list. (You'll find this can also be done easily by the MERGE 
command tn the MOREPOWER program Included on the POWER 64 dtsk.) 

We'll briefly mention the SEL command again here. You've met It during 
our "Instant key" discussions, and you'll meet It again. To keep things 
neat and to complete our description of POWER 64 commands we'll cover It 
In this chapter. 

The TEST and BACK commands allow you to work with a second Basic program 
while keeping your main one In memory. 

Skip the parts of the chapter you don't need for now. The advanced 
features will be there when you need them. 

FIX and PTR. 

Basic usually takes care of Itself. The Baste Interpreter uses several 
Internal "pointers" to keep track of where things are, and these 
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pointers usually behave properly as they should. 

However, If you LOAD a machine language program to an unusual part of 
memory, the pointers can get muddled and give you trouble. The biggest 
problem Is with a pointer called "Start-of-Variables"; after a Baste 
LOAD, It ends up pointing just beyond the last byte loaded. Sometimes 
that's all right; but other times It will cause the computer to give you 
Instant TOUT OF MEMORY, and In one horrible case It can cause your 
program to destroy Itself when you say RUN. 

Some Machine Language Monsters. 

If you work with Machine Language, thts Is worth looking at more 
closely. The circumstances that give trouble are usually these; you 
have a Basic program already tn memory, and you wish to load a Machine 
Language routine to some memory location where It will leave your Basic 
program untouched. The most popular places for this are; at the top of 
Basic memory space; and In a Cassette buffer. Whichever location you 
use, you'll set the Start-of-Vartables pointer to an awkward value when 
you bring the ML (Machine Language) program In with a Basic LOAD. 

If your ML program goes to the top of Basic memory space, the pointer 
will end up looking at the top of memory. This means that there will be 
no space for variables, and you'll get ?OUT OF MEMORY the moment you try 
to do anything useful. These are Count Dracula program loads: they 
have drained away the program's life blood - Its vartable space. 

On the other hand. If your program goes Into a cassette buffer, the 
Start-of-Vartables pointer will be set below your Basic program, and 
your variables will be written down there. Not only Ts this an unusual 
place to put variables, but as you write more and more variables they 
will work their way up and eventually will start storing over the Baste 
program Itself. These are Frankenstetn variables, which eventually 
destroy their creator - the Basic program. 
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FIX fixes all these problems. It restores the pointers to their normal 
locations In relationship to the Basic program. Technical tyros will 
want to know that FIX searches memory for the three zeros that signal 
the end of Basic, and then parks the pointer behind them. Non-technIcaI 
duffers may think of FIX as a combined silver bullet, wooden stake, and 
collection of enraged villagers. 

One last comment for advanced users of FIX. In the special case where a 
combined Baslc/ML program has been created with the Machine Language 
following the Basic, FIX needs to be used carefully. In this case, the 
Start-of-Varlables pointer Is set behind the Machine Language coding. 
FIX will zap this pointer so that It points to the end of the Basic 
program. This Is great for making a quick change In the Basic program 
(the ML won't move), but remember to put the pointer back before running 
or saving the program. If you forget, the variables will write all over 
your Machine Language program: this Is known as the dreaded Curse of 
the Mummy's Tomb bug. 

FIX also resets POWER 64 and prints the copyright message. If you find 
anything Is going wrong with POWER 64, try the FIX command. If you 
reset your 64 by holdtng down the STOP and RESTORE keys at the same 
time, you'll find POWER 64 Is gone, but typing FIX will bring It back to 
life. 

The PTR command does pretty much what FIX does but It does not reset 
POWER 64*s Internal data. You'll find It handy after having loaded a 
machine language program from disk or tape. You should note, by the 
way, that on the 64, the only way you can load such a program Is by 
giving a second number on the LOAD command after the device number. 
This second number Is called the secondary address, and If It Is not 
zero. It allows a program to load Into memory where It was supposed to, 
rather than where Baste programs go. 
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EXEC: Execute From File. 


The EXEC command allows another devtce to take control of the 64. The 
keyboard normally controls 64's activities; but with EXEC you can 
re-assign control to some other devtce. 

That's powerful: so powerful, tn fact, that It's hard to grasp all the 
possibilities that the EXEC command opens up. We'll stay with a few 
simple examples here; even those open up remarkable new possibilities. 

The most dtrect application of the EXEC command Is to transfer control 
of your 64 to a sequential file on disk or tape. The procedure Is: 
first, open the file and then transfer command with EXEC. 

The sequential file used for command (we'll call It the command file) 
may do almost anything that can be done from the keyboard. It might 
LIST, set a variable, LOAD a program, or even change a line of Basic. 
The POWER 64 system prints the commands on the screen of your computer 
so that you can see what's going on. Control will return to the 
keyboard when the end of the file Is reached; you may a I so press the 
RUN/STOP key to regain control. 

Merging Basic Programs. 

It's very useful to be able to merge two programs together. The most 
common uses of a merge are to add DATA statements to one or several 
programs, and to Include subroutines. There are many other possible 
uses, however: for example, you can bring In a preset group of Instant 
phrases to use with the POWER 64 system. 

Keep In mind that this Is a true merge - the new lines Interleave with 
the old, and duplicate line numbers cause the old program line to be 
completely replaced with the new. It's as If you typed In the new lines 
at the keyboard to add to or change your program. That's what the EXEC 
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command Is all about: making the file behave as If It were typing at 
the keyboard. 

You should note that If you have loaded In the MOREPOWER package 
described later In this manual, you can do a merge directly from the 
disk wtth the MERGE command. If you want to merge from tape, or don't 
have MOREPOWER In: the following method should be used. 

Here’s the general procedure: we write a sequential file containing 
program lines that we will want to merge Into other programs. Once the 
file Is written It may be used over and over again to merge the desired 
lines Into some other program. 

Writing the Merge File. 

We'll call the sequential file a "merge file". Here's how we write It - 
the examples show dtsk files but you can easily adapt It to cassette 
tape If you wish. To create a merge file we first load the program 
lines that we will want to merge Into the computer. Then we write them 
out with a statement like: 

OPEN 1,8,3,"0:MERGFIL,S,W" : CMD 1 : LIST 

Be sure to type all three Basic commands on a single line. When dtsk 
activity stops tidy everything up with: 

PR INT#1 : CLOSE 1 

... and our file Is wrItten. 

There are several variations that you can use when writing the file. If 
you are using tape you'll type OPEN 1,!,1,"MERGFIL" at the beginning. 
You can of course choose any file name that Is suitable. And finally, 
you don't need to send the whole program In memory out to the merge 
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file: you can choose to send a selected portion such as a subroutine, 
with something like LIST 500-600. 

You may have noticed that we have written our merge file without 
POWER 64's help. We have used standard Basic commands throughout. 
POWER 64 comes Into play when we do the actual merge Itself. 

Once the merge file Is written we may do a program merge right away. 
Alternatively, we can use the merge file at a later date - perhaps 
months Iater. 

Merging Programs. 

When you are ready to perform the merge, load the second program - the 
one you want to mix with the merge file program. Now POWER 64 will do 
the job simply and easily for us. Type: 

OPEN 1,8,3,"MERGFIL" 

Now we're ready to go. Just type EXEC 1 and POWER 64 will do the rest. 
You'll see the lines coming In from the merge file - they will be 
displayed on the screen. As they are displayed they are also Inserted 
Into the program In memory. 

Everything happens gutte fast and the merge will be complete very 
gutckly. There may be an error statement at the end of the merge; don't 
worry about It. For those people who will worry about It anyway, here's 
a hint: the error notice Is caused because the word "READY." Is on the 
file, which causes the computer to try to execute a READ statement. 
Which proves the old proverb: computers are dumber than people but 
smarter than programmers. 

If anything went wrong with the merge you should be neat and tidy up 
with CLOSE 1 which puts the merge file to sleep unttI you need It again. 
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The computer and the disk unit will appreciate your efforts to keep the 
files clean and orderly, 

A Small Step for a Commodore 64... 

You may not have not teed, but an Important new concept has been 
Introduced here. We've broken the barrier between programs and data 
files. Now we can change programs to data and analyze them ... or 
Invent a program to write data files which In turn are changed Into 
programs. Have you ever heard of programs that write other programs 
before? How do you feel about your computer writing Its own programs 
and making you obsolete? 

The Idea of allocating control away from the keyboard Is also profound. 
It's like being able to put the computer on autopilot. 

These are advanced Ideas. Don't worry about computers taking over, 
however. If you hear something tlptolng around your house In the middle 
of the night It's probably the cat or a burglar. It Isn't your 
Commodore computer. Unless you have a very long extension cord. 

Pitfalls and Pratfalls. 


When you write a MERGE file, be sure that the program lines don't LIST 
In such a way that they are over 80 characters long. If necessary LIST 
the program on the screen first and make sure It's OK. Change any lines 
that are too long Into two program lines. 

Lines that are too long produce exactly the same effect as If they were 
typed In at the keyboard. You know what happens when you type In over 
80 characters before you press RETURN. If you don't know, try It. It 
doesn't work right; that's what happens. 
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If you are using some of the advanced features of the EXEC command 
remember that the sequential file may only give the same Instructions 
that are allowed on the keyboard. This means that you can't Include a 
dtrect INPUT, GET or DIM on the file... just as you can't type these 
statements Tn at the keyboard. 

It may be stating the obvious, but don't try to create a program bigger 
than the memory space you have available. It won't work. 

SEL: Select Instant Option. 

We've met this command before. This Is a good time to summarize Its 
features. 

SELK- turns Instant keywords off; SELK+ turns them on. Instant 
keywords were discussed In section 4. Instant keywords are normally on 
unttI you turn them off. 

SELR+ turns "REM" Instant phrases and Instant subroutines on; SELR- 
turns them off. Instant phrases were discussed In section 7; Instant 
subroutines will be dealt with In section 10. Instant keywords, phrases 
and subroutines are normally on until you turn them off. 

SELP+ enables the metacharacters for pattern matching; SELP- disables 
them. If you've forgotten about metacharacters, go back and read 
section 6. "Metacharacter" Is a good word to have In your vocabulary. 
It sounds Impressive when you slip tt Into conversation; for example, 
you might casually say, "The other day I metacharacter who didn't even 
have a POWER 64 system on his Commodore 64... ". 

SEU+ turns on the Instant phrase feature during the running of a Basic 
program, so that you can use them during an INPUT response. This can be 
very handy for giving "canned" Input during program testing. SELI- 
dI sables this feature. 
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TEST; Switch to Alternate Program 

The TEST command allows you to temporarily suspend work on the Baste 
program In memory to work on another one. No saving or loading from 
disk or tape Is required, and when you are finished with the new program 
you can go back to the old one. 

TEST works by telling Basic to use a different area of memory than It 
normally does. When you fssue It, It finds the end of the program you 
are working with and sets up a new area Immediately after It In memory. 
If you know a bit about how Baste uses memory. It might help you to know 
that the new area Is In the memory that was formerly occupied by the 
array variables of Basic. 

Let's say you're working with a Basic program and you decide you want to 
test something out with another Basic program. Just type TEST. 

Baste will now print READY, as usual. Now, since you want to try 
something new, type the NEW command to make sure the new Basic work area 
you have created Is empty. Under special circumstances described below, 
you will not want to type NEW, but In just about every other case you 
will, so type It. Don't worry about your old program. It Is safe, and 
you will see It again. 

You now have a whole new area to write a program In. You can type In 
lines, edit them and run them. You can also LOAD a Basic program off 
the disk or tape, RUN It, play with It and SAVE It. You must be 
careful, however, that this program Is pure Basic, and doesn't have 
anything In It that might be affected by the different memory It Is 
running In. Most notably. It can't be a program with any machine 
language, such as the program that loads POWER 64 Itself. Pure Basic 
programs are free spirits, however, and don't care much where you put 
them, so you should have no trouble working with them. 
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You may have loaded In a program just to look at It, or created a 
special routine to draw a picture. Whatever It Is: don't worry, your 
other program Is safe. You can restore It by using the BACK command 
described below. 

BACK: Restore old Program. 

As the name suggests, the BACK command takes you back to the old program 
you had In memory. This Is the program located at the normal place In 
memory for Baste programs, which Is the memory starting at loeatton 
2048. Type BACK and your old program will appear again after you have 
done a TEST. Its variables and arrays will be gone however, so you 
should not have left anythtng valuable tn them. 

Once you go BACK, you can not normally return to any program you set up 
while In TEST mode. Be sure to save your program before you type BACK 
If It Is valuable to you. 

Using TEST and BACK with PAL. 

There Is a spectal product called PAL (personal Assembly J^anguage) which 
Is a machine language assembler for the Commodore 64 computer. It helps 
you to write machine language programs once you have become a bit more 
sophisticated In the use of your computer. It Is available from 
Pro-Line Software Ltd. through your local Commodore Dealer, and can also 
available combined In a spectal package with POWER 64. 

The TEST and BACK commands are especially useful for testing combined 
Baste and Machine Language programs produced with PAL. See the section 
of the PAL manual on the ".BAS" pseudo-opcode for details. When TESTIng 
a PAL produced program of this nature, you should not type NEW after 
using the TEST command. 
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10. THE INSTANT ACTION KEYBOARD, PART 3: INSTANT SUBROUTINES. 

We saw In section four how a single key could call up an entire Basic 
keyword. In section seven we found out how to have a single key 
translated to a-phrase of our own choice. Now we'll look at the third 
aspect of Instant action - how to make a single key run an entire 
subroutine for us. 

Note, that once again, we're going to use lower case for this example so 
that tt Is easier to read. You can switch back and forth between lower 
case and graphics on your 64 by holding down a SHIFT key and the 
COMMODORE symbol key at the same time. 

Suppose we have a subroutine starting at line 8000 that we wish to run 
whenever we press the Shifted S character. We would set this up with: 

1 rem”S<8000 

Note that the format Is similar to that of Instant phrases. The equals 
sign has been replaced with a left-arrow character, and the phrase 
Itself has been replaced with the tine number of the subroutine. 

Wtth the above coding In place the Instant subroutine Is ready to go. 
The moment we touch the shifted S key, the subroutine at Baste line 8000 
Is running. The subroutine may contain any legal Basic code; tt must 
end with a RETURN statement, of course. 

We may disable the Instant subroutine feature with same SEL R- command 
as for Instant phrases. SEL R+ reconnects the feature, of course, and 
causes Instant subroutines and Instant phrases to come Into action 
again. 


Page 46 



POWER 64 Manual 


10: INSTANT SUBROUTINES 


What to use It for. ^ 

The uses are almost limitless. You'll want to strike a balance between 
your use of Instant phrases and Instant subroutines. If a job can be 
done with a direct command to Basic. It will probably be easier to call ^ 

It up from an Instant phrase, striking the RETURN key after the phrase 
appears on the screen. 

When the job gets too big for a direct Basic statement - or If It needs 
commands like GET or INPUT which aren't allowed within direct statements 
- you'll want to go to Instant subroutines. 

Here's a list of just a few things you can do using Instant subroutines: 

—print arrays; search arrays for the biggest value, or a certain 

desired value; i 

—print the time of day or elapsed time on the screen; 

— INPUT or GET a value from a file, for testing purposes; 

—perform hexadecimal to decimal conversions, or vice versa; 

—do disk operations. 

Quick tricks. 

There are one or two "cute” techniques that come In handy with Instant 
subroutines. They are probably too clever for use In normal Basic 
programming, but can make Instant subroutines even more convenient. 

They have to do with opentng files for Input. Normally, you might want 
to Input from devices 1 or 2 (tape) or device 8 (disk). It Is 
possible, however, to open device 0 (the keyboard) or device 3 (the 
screen). 

It seems curious that we would want to open keyboard or screen as an 
Input device. After all, the INPUT statement takes Input from the 
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keyboard/screen. Why use the peculiar OPEN to name the keyboard or 
screen as a device? There are a few possible reasons, chief among which 
are: to eliminate the prompting question mark; and to eliminate a 

program halt If RETURN alone Is pressed. 

t Opening device 0 (keyboard) for Input produces: no prompt; no halt If 

RETURN alone Is pressed; and no move to the following line after INPUT. 
' It can be a handy way to link Input data to a command generated with 

Instant subroutines. You'll see an example later In this sectton. 

Opening device 3 (screen) for Input causes a peculiar thtng to happen 
during the INPUT statement Itself. There Is no prompt, and the Input Is 
taken Instantly from the screen - the user Is not Invited to type. Thts 
means that the desired data must be on the screen before the INPUT 
command Is given. It's possible to do some very clever things by 
positioning the cursor over the begtnntng of a number. Invoking INPUT on 
a file set to device number 3 ... and the number will be picked from the 
screen for you. 

Device 3 can be somewhat dangerous to use, depending on the system you 
have. If you try to Input from an empty screen, you could be In big 
trouble. Before doing too many clever things, experiment; get a feel 
for how it works. 

Some disk uttIttles. 

If you have loaded the M0REP0WER package tn your machine with its DISK 
command and pre-deftned keys, you'll find It useful to have some disk 
routines tied to Instant keys. If you do have the package In, these 
\, should serve as handy examples. Here are a few for you. 
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Disk status: to get the dtsk status or error code, the following 
subroutine will come In handy. You'll probably want to link It to a 
shifted S for status. 


7000 REM GET DISK STATUS 
7010 OPEN 100,8,15 
7020 INPUT#100,E,E$,E1,E2 
7030 CLOSE 100 
7040 PRINT E;E$,E1;E2 
7050 RETURN 


You can see that the codtng Is quite straightforward. There Is a 
potential problem that you'll need to watch, however. In opening and 
closing the disk command channel (secondary address 15), all active 
ftles on the disk unit are automatically closed. So once you call this 
subroutine In Its present form, you won't be able to continue reading or 
writing any files that were underway at the time. 


We use logical file number 100 In the hopes that we don't get mixed up 
with other files which may already by open. And you should confirm that 
variables E, E$, El and E2 don't conflict with any other variables In 
your program. 


Getting a disk catalogue: the following subroutine will get the 
directory from drive zero of the disk and print It. You might want to 
link It to the Shifted C key as an Instant subroutine. 


8000 OPEN 100,8,0,"$0" 

8010 GET#100,A$,B$ 

8020 GET#100,A$,B$ 

8030 IF ST<>0 GOTO 8100 
8040 GET#100,A$,B$ 

8050 N$=CHR$(0) 

8060 PRINT ASC(A$+N$)+ASC(B$+N$)*256; 
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8070 GET#100,A$ 

8080 IF A$="» THEN PR I NT:GOTO 8020 
8090 PRINT A$; : GOTO 8070 
8100 CLOSE 100 : RETURN 

Once again, we have chosen logical file 100 for our Input, In the hope 
that It desn't conflict with anything else. Line 8000 opens the 
directory file; we could substitute "$1" If we wanted to read the drive 
1 directory. Line 8010 throws away the first two bytes from the 
directory: they will not be needed. 

Lines 8020 to 8090 Input a line of the directory. The first two bytes 
are thrown away (line 8020); the next two bytes are the number of blocks 
In binary, and we must do a conversion to decimal before we print (line 
8060). The rest of the directory line Is pure ASCII, and we may simply 
read It and print It (lines 8070 to 8090. In the meantime, line 8080 
spots the end of a directory line and takes us back to 8020 where we 
deal with the next directory entry. 

Care should be taken as always to ensure that variable names do not 
confltct with those tn the rest of your program. 

Sending a command to disk: You might choose a Shifted D character to 
Invoke this procedure. 

9000 OPEN 100,0 : PRINT "DISK:"; 

9010 INPUT#100,01$ : PRINT 
9020 CLOSE 100 
9030 OPEN 100,8,15 
9040 PRINT#100,DI$ 

9050 CLOSE100 
9060 RETURN 


/ 


Page 50 




POWER 64 Manual 


10: INSTANT SUBROUTINES 


We use the trick of opening the keyboard (device 0) as a file. A prompt 
of DISK: Is printed, and then we input the desired command string. Out 
It goes to the disk, and the job's done. 

Remember that opening and closing the command channel on disk (secondary 
address 15) causes all other files on the disk unit to be closed. 

Disk Wrap-Up . 

The above sample routines will be useful If you don't have the newer 
Basic which contains disk commands. They work on all Commdore machines, 
of course. If you have the MOREPOWER package In, you might still like 
to try them as an exercise; normally, you'd use commands such as DISK, 
ERR and LISP'S" to do the functions you want. 

Summary. 

You can call In any of a whole galaxy of subroutines with the touch of a 
key. It's handy and tt's powerful. 

There's really no difference between a subroutine and a program. If you 
like, you may use the Instant subroutine system to select any one of a 
group of programs as desired. So long as you have room for them all 
they can co-exist peacefully, sharing the same memory space and using 
common variables. You might select a read routine to bring In data from 
a file; then an Input routtne to add to the data; then a sort routine to 
sort It all; then a write routine to put the new data to the disk or to 
a printer ... the possibilities are endless. 

Practice a little. You can make some very powerful systems once you get 
the knack of Instant action subroutines. 
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11. ADVANCED POWER 64 TECHNIQUES. 

It probably goes without saying that you can and should combine various 
features of the POWER 64 system to work together. 

Use Instant phrases to call up other POWER 64 features such as 
renumbering. During development of a program, lt*s a good Idea to SAVE 
at frequent Intervals; you may use Instant keywords or Instant phrases 
to do this. 

The remainder of this chapter will deal In a conceptual way with 
advanced features. Most of these are machine langage oriented, so that 
you may not be able to tap these capabilities If you don't have 
expertise tn that area. Read through anyway: It's always useful to 
know what's In there so that you know where the system can be taken In 
the future. 

Make your own keywords. 

POWER 64 has Its own table that tells It what to do when a key Is 
pressed. For example, when you type a shifted L, this table tells 
POWER 64 to print the LIST keyword on the screen. When you hit the RUN 
key, this table says to print RUN on the screen and also act like a 
RETURN key had been hit. 

POWER 64 also allows you to define a table just like the one It uses, 
and If you do. It will even search your table before Its own, so that 
you can have complete control over what Is done on your computer when 
any key Is hit. 

With this table, you can make any key print any string up to 255 
characters In length, and you can even have a RETURN at the end of the 
string so It Is executed by the 64 right away. You can also easily 
define any key to print any keyword (n the keyword table of the 64 by 
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giving Its token number. 

Finally, you can define any key to call any machine language subroutine, 
giving you the full POWER to do whatever your heart desires. 

You’ll find precise details on how the Instant keyword table works tn 
Appendix D. 

Adding POWER 64 commands. 

POWER 64 finds Its various commands, such as AUTO, RENUM, or DUMP from 
an Internal table of command words. If you'd like to add features of 
your own, POWER 64 has made special provision for this. 

Before checking Its own Internal command word table, POWER 64 looks to 
see If you want to perform your own tests. There’s a location where you 
may place an action address If you wish; the POWER 64 system checks this 
location, and If the address fs valid, you'll get control. 

The address you store Is carefully checked for correctness; the method 
used Is a checksum test. You must get your address right for POWER 64 
to recognize you. Once It does, however, you will take over the action 
until you return control to the POWER 64 system. 

Note that you get first shot at checking the command; this means that 
you can override an existing POWER 64 command tf you wish. Keep In mind 
that If you don't find any of the commands you recognize, you must pass 
control along to POWER 64 to allow ft to check for Its own commands. If 
POWER 64 In turn doesn't find anything tt recognizes It will return 
control to the Basic Interpreter; the command may be standard Basic, or 
tt might be a syntax error. Basic has the last look; It will either 
perform the action or report the error. 
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So you could create new commands that mtght display array values, 
perform disk activities, delete REM statements, or do any other tasks 
you deem useful. POWER 64 can't do everything that you might Imagine; 
but It gives you the hooks to add on such features. 

You'll find a detailed description of how to link your own commands Into 
the POWER 64 system In Appendix D. In addition, you'll find the source 
for a PAL assembler program that does what you need to add commands 
exactly the way the MOREPOWER package does tt. 
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12. SUMMARY. 

This User Guide has trted to take you through the features of the 
POWER 64 system one simple step at a time. The method has been to 
encourage you to get your hands on the machine. If you've gone through 
some parts without actually touching the computer, make a point of going 
back and trying them soon. You'll find that many of the features feel 
naturaI. 

If you feel overwhelmed by the rich variety of features that POWER 64 
offers, you might like to slow down and take things one step at a time. 
Even If you use only a quarter of the capabilities of POWER 64, you'll 
still be gaining many beneftts; and you can add the extra features to 
your repertoire as you need them. 

Remember that the Instant action keyboard features can be turned off 
(wtth a SEL command) If you don't want them or If they get tn the way. 
And you may shut down the whole POWER 64 system by using the OFF 
command. 

Good luck with your new system. You'll write better programs faster and 
more easily. But keep In mind that POWER 64 Isn't a substitute for 
brains. Your programs will be good because you make them good. Don't 
be modest and give POWER 64 all the credit. Just be glad It's there. 
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APPENDIX A: The MOREPOWER Package of extra POWER 64 commands. 


How It Works. 


POWER 64 contains plenty of added features for your Commodore 64, and 
after reading the POWER 64 manual, you may think It has more than 
enough. If you have a disk unit, though, you'll find out very soon that 
there are a lot of things about disk operation that could be more 
convenient. MOREPOWER to the rescue! 

MOREPOWER contains a whole bevy of additional handy commands that have 
been placed onto POWER 64 by means of the built In hooks left In 
POWER 64 for this purpose. It Is just one of several packages of extra 
goodies for POWER 64 that you should see around In the near future. 

MOREPOWER contatns many fancy dtsk commands, and It also contains stuff 
for defining keys for even more Instant phrases. 

How to Load MOREPOWER. 

Most people want to have MOREPOWER with POWER 64 all the time If they 
have a disk system. This Is easy to do. As you wtll recall, to engange 
POWER 64 you simply load It off the disk and type RUN. What the main 
POWER 64 manual didn't tell you Is that you can select certain options 
by entering certain characters after the RUN command. 

For example. If you type "RUN:1" you will find that both POWER 64 and 
MOREPOWER will load In together and be set up properly. You wtll know 
this because the disk will still be loading after you see the POWER 64 
copyright message appear on the screen. 
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If you type "RUN:2", you won't get MOREPOWER, but you wtll find that 
your copy of POWER 64 wilt load up Into a special area of htgh memory 
that your Commodore 64 has. This will mean that POWER 64 will take up 
none of the memory Basic uses, which could be Important If your programs 
use up a lot of memory. The place POWER 64 loads Is just below address 
"$D000" In hexadecimal. You should be careful when loading POWER 64 
there because only one program the size of POWER 64 can exist In that 
memory. 

If you add 1 and 2 together you might figure out what "RUN:3" does. You 
guessed It: this wtll provide you with POWER 64 and MOREPOWER together, 
and will put POWER 64 In the special high area of memory you were just 
told about. If you know no other program wants that memory, this Is the 
option for you. 

If you don't load MOREPOWER In at the start, you can still get It after 
loading In POWER 64. With POWER 64 In place, just type: 
LOAD"MOREPOWER",8 and when tt has loaded In, type RUN, just like you do 
for POWER 64. It will then be linked In and you'll have even MOREPOWER 
at your fingertips. 


The MOREPOWER Commands 


All MOREPOWER disk commands Ignore all data 19 characters after the 
start of the file name. This allows all MOREPOWER disk commands to be 
Issued by getting a disk directory on the screen, moving the cursor up 
to the desired ftle and typing (n the MOREPOWER disk command In front of 
that file name. Wtth MOREPOWER, you need never type another file name 
for loading If you don't want to. 
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DEVICE 


The MOREPOWER disk commands all take a filename with an optional device 
address and secondary address j ust 11 ke norma I Commodore 64 I /0 
commands. The difference Is that If you do not provide a device, 
MOREPOWER commands will assume the you want the default given by the 
DEVICE command. If you don’t use the DEVICE command, the default device 
will be 8, which Is normally your disk drive. 

To make the default be device 9, for example, just type the command: 
DEVICE 9 and hit RETURN. 

Commodore 64 commands default to device 1, which Is the tape drive, 
which Is generally a bad Idea If you have a disk. You can get this, 
however, by typing DEVICE 1. 

DISK 

The DISK command lets you send a string to the disk command channel. 
Typing: 

DISK"Command" 

Is the same as: 

OPEN 1,8,15:PRINT#1,"Command" 

... and you don’t have to deal with opening files and other problems. 
You can use this to Initialize disks, scratch files, copy files and many 
other purposes. Disk commands are Itsted In your Commodore disk manual. 
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ERR 

This command prints the disk error channel. Issue It If the disk error 
light Is on. It takes no arguments. You can also get the error channel 
printed by hitting the "f4" key on the right side of your keyboard. 

LIST 


What's so special about LIST - everybody knows It's a standard command 
In the 64, right? Well, that's true, but MOREPOWER adds an extra 
dimension to this command by giving It the ability to list and let you 
look at disk files without disturbing the program In memory. 

The secret Is to type a filename, tn quotes, after the LIST command. 
For example. If you have a program called "B PROG” on the disk, you can 
type: 

LIST"B PROG" 

and you will see the program, assuming tt's In Basic, appear on the 
screen just like you loaded It and typed LIST. You'll find thts LIST 
has some extra features, too. For example, at any point you can hit 
any key and that will pause the listing so you can look more carefully 
at It. Hitting any other key wtll start It going again. True, (f you 
hit the RUN/STOP key, the listing wtll stop, and you'll have to start It 
again, but that's probably what you wanted, or else why did you hit the 
RUN/STOP key? 

You wtll find yourself using this command a lot. In particular [f you 
are programming a large project that requires several files. You can 
use It to answer questions like: "What did I call that array?" and "How 
did that program use the GET statement?" without having to save your 
program and load another one. You'll find this a big time saver. 
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You might remember now. If you have used the disk a lot, that the disk 

directory loads In just like a Basic program does. If that's the case, 

you should be able to LIST It just like any other Basic program. You 

sure can, and It turns out to be one of the best features of the new 

LIST command. Just say: 

LIST"$" 

and you will see your disk directory. You may also be Interested In 
knowtng that key "f2" has exactly this effect as well! 

MERGE 


As noted tn the main POWER 64 manual, you can use the EXEC command to do 
all kinds of amazing tricks. Including a program merge. MOREPOWER has a 
command to make that merge process a bit more convenient If you have a 
disk. If you have one program In memory and want to merge another one 
In with It, just as described In the section on EXEC, just type: 

MERGE"PROGRAM" 

In this case, the PROGRAM Is a standard loadable program file and you 
need perform no special conversion on It. You'll ftnd the operation of 
MERGE to be quite similar to that of EXEC, and you can hit the RUN/STOP 
key to halt It, too. It should run a little faster than an EXEC while 
It's at It. The same warning that you were given In the EXEC section 
about not trying this without enough memory goes double here! 

RUN 

Thts Is yet another built-In command of the 64 which has been enhanced 
by MOREPOWER. Just like LIST, RUN can now be given the name of a file 
In quotes. It will load that file Into memory and RUN It. In fact. 
It's just the same as typing LOAD with the ftle you want and then typing 
RUN. 
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Since all MOREPOWER disk commands mill work off a disk directory, you 
can pick up a handy trick from this. With POWER 64, the RUN key 
produces a RUN and a RETURN. You can use this to save a lot of typing 
when loading programs. For example, say you have (let's be honest) your 
GAMES disk In the drive. You can hit key n f2" and a dtsk directory will 
appear on the screen. Simply move the cursor up to the game you want, 
and hit the RUN key. With no more typing, your program will be brought 
Into memory and run - just like that! 

There's another, very Interesting way of loading a program Into memory 
and running It that will be described later. 

LOAD 

Yet another altered command, the LOAD command has been modified simply 
to use the MOREPOWER disk command rules. This means you don’t have to 
type ",8" every time you use this command on dtsk, and you can also use 
It tn a disk directory. 

While POWER 64 defines key "fl" to be LOAD, MOREPOWER defines key "f8" 
to be LOAD followed by a RETURN. Thts means you can play the same trick 
described for RUN when using LOAD. Get a directory on the screen, move 
the cursor to the program you want, and hit the "f8" key. That’s all 
you have to do and your program will be on Its way Into memory. 

START 


START Is a command that tells you the location where a dtsk program file 
ts supposed to load. It gives It In decimal and hexadecimal, and Is 
handing In dealing with machtne language programs. When dealing with a 
Basic program, It doesn’t matter where It ts supposed to load. 
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SIZE 

This command wtll tell you the size of a disk file In bytes, giving the 
value In both decimal and hexadecimal. If you don't give It a file. It 
will tell you the size of the current program tn memory. Unlike the FRE 
function of Basic, this command tells you how much memory you are using, 
rather than how much you have left, and doesn't deal with memory taken 
for variables and strings. 

TEXT 

TEXT Is a command very much 11ke the mod IfIed LIST command except that 
It takes sequential files and lists them rather than Basic files. You 
might know these as data files, and they show up wtth an SEQ beside 
their names In a disk directory. Otherwise, TEXT works just like LIST. 

Subsystem Loading 

We now come to a very special feature of MOREPOWER - one that lets you 
define your own commands for the 64 very easily. Let's say you have a 
Baste program on the disk that does something - anything. It might 
print# your name over and over or compact another Baste program. You 
might be sitting worktng with one Baste program and find the need to 
quickly load In and run another. Your first program you might call a 
"system" and the second program would be a "subsystem" 

One way you might do this would be to use the TEST command, load In the 
new program, RUN It and use the BACK command when It Is finished. 
MOREPOWER allows you do do all this In one stroke, and even from a 
directory listing, no less. 

All you need do Is type the ftlename of the Basic program you want In 
quotes. No command, nothing else - just start the line with a quote. 
MOREPOWER will save away the Important Information about your original 
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program and create a new area of memory for the program to load Into. 
The new program will then be loaded Into memory and run. In a similar 
fashion to that of the modified RUN command. 

When the program Is finished, however, your old program will be 
Immediately restored - not just the text, but all the variables and 
arrays as well. (Strings may not survive but all numbers will.) This 
happens when the subsystem finishes for any reason, which Includes an 
error or your httttng the RUN/STOP Key. It will be as though the 
subsystem program were never there. Remember, though that the subsystem 
program should follow all the rules that a program you can load In under 
the TEST command must follow - te. It can't contain machine language or 
any absolute memory references to within It. 

This may seem like a bit of magic, and In some ways It Is for It 
provides you with the POWER to program your 64 with all kinds of handy 
commands even If all you know Is a little Basic. 

If you know more than a little Baste, and have a machine language 
program on the disk, you can load ft In like a subsystem, too. Placing 
an exclamation point In front of the file name In quotes will cause 
MOREPOWER to load the given ftle Into memory at the address It says It 
belongs, and also to start It running at that address. This can save 
you figuring out a funny SYS number for the average machine language 
program. 

You should watch out when loading machine language programs like this. 
Many such programs are not designed to run from their first address, and 
If you use this command your machine could well crash! A tried and true 
command should give you no trouble of course, but don't just go typing 
random names after an exclamation point, or you'll be sorry. 
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UNDO 

This command will UNDO the effects of a NEW If you Issue It before any 
command that uses memory. This Includes anything starting with a line 
number or anything that assigns to a variable. If you haven't done any 
of these operations, and you suddenly realize you did not want to type 
NEW, UNDO can save your day. 

HEX 

The HEX command Is very handy for people working with the hexadecimal 
address system. If you follow the HEX command with a Baste expression. 
It wt 11 print out the value of the expression (usually a number) In 
hexadecimal. On the other hand. If you follow the HEX command with a 
dollar sign and a hexadecimal number. It will give you the decimal value 
of that hexadecimal number. A good way to handle all that annoying 
conversion work when using PEEKS, POKES and SYSes. 

KEY 

The KEY command lets you define a whole new class of Instant phrases and 
subroutines. As you will recall, POWER 64 allows you to define Instant 
phrases and subroutines by using REM statements at the start of the 
program. These are very useful, tn particular for strings relevant to 
the program being worked upon. The KEY command lets you define Instant 
phrases and subroutines that don't change from program to program, and 
stay until you turn POWER 64 off on your machine. 

The secret Is the POWER 64 key table, similar to the one used to map a 
shifted L Into the LIST command. When you start MOREPOWER up. It 
creates a table for you to put your own key definitions Into, and the 
KEY command lets you do this. See the section on machine language 
Interfaces for more details on how this Is done. 
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Say you want to define a key to print a string. You might try: 

10 rem"N=Albert Gonk" 
but you can also try: 

key "N", "Albert Gonk" 

This will define the shifted N key as long as there Is not a REM style 
Instant phrase superceding It. It also means that you can't get NEXT 
from the shifted N key like you used to. Keys defined In this way can 
be turned on (If they are not already) by SEL K+ and off with SEL K-. 

Just typing: 

key "N" 

will get rid of any definition you gave for the shifted N key. Of 
course, you can define any key, not just shifted N. 

You will be happy to know that the last character In the string you give 
Is not printed on the screen, but actually replaces the character you 
typed. This means that If the last character Is a RETURN, It will seem 
as though you hit RETURN on the line the cursor Is on. Try: 

key "N", "?3+5"+chr$(13) 

and then hit the shifted N key. Don't forget to have SEL K+ on at the 
time. Buy the way, you can't have a chr$(0) In your string, nor define 
that character. 
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You can also have any key set to call a machine language subroutine. 
Say you have a machine language routtne at address 30000 In memory, (If 
you don't know any machine language, don't worry about this.) You can 
then say: 

key "N" sys 30000 

and your routtne will be called each time you hit the shifted N key. 
If, when the routine exits, the carry Is clear, POWER 64 will do nothing 
unusual when It Is finished. If the carry Is set, however, POWER 64 
will treat the character In the accumulator like It was typed at the 
keyboard, so you can play the same trick with the RETURN. 


Built In Keys 

When you use MOREPOWER, the four shifted function keys on the right of 
the keyboard get definitions, which. Incidentally, you can change with 
the KEY command. Most of these have been noted above, but we'll Itst 
them here to be complete. 

The "f2" key gives a disk directory. 

The "f4" key prints the dtsk error channel. 

The "f8" key prints the LOAD keyword and a RETURN 

The "f6" key puts you Into AUTO mode In a very spectal way. To use 
It, place the cursor on a line on the screen that contains a Basic line 
number, generally a listing of that line. If you hit the "f6" key, 
MOREPOWER will read the line number off the screen and move the cursor 
to the bottom of the screen. There It will put you In AUTO line number 
mode at one plus the Itne number read off the screen, with a line step 
of one. 
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What this doss Is allow you to easily add lines after a given Itne 
(assuming there Is room for them) with the touch of one key. 

Future Additions 

MOREPOWER Is destgned to link onto POWER 64 and to allow other packages 
to Itnk In before or after It In a chain. Expect to see even MOREPOWER 
commands and defined keys In the future, both from the author of 
POWER 64 and other users of It. 
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APPENDIX B: TROUBLESHOOTING POWER 64 


In the unlikely event that you cannot seem to load POWER 64 from the 
disk, check out a few things before panic sets In, Relax a little, 
there are thousands of copies of POWER 64 In dally use and they all work 
beautifully. The trouble Is probably something pretty obvious. 

1. Check that the power plugs are all securely In the wall socket. 

2. Check that the connecting cables are all plugged Into the correct 
places. 

3. Are you trying to load the right disk? 

4. Does any other disk load properly? 

5. If It does, read through your POWER 64 loading Instructions step by 
step and try again. 

6. If POWER 64 still won't load, contact your dealer. 
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APPENDIX C: FORMAL DESCRIPTION OF POWER 64 COMMANDS, 
by: Brad Templeton 


Optional Information ts shown In parentheses. For example: AUTO 
(I tne-number(.Increment)) means that you may type AUTO or AUTO 100 or 
AUTO 100,10. 

The keywords are given tn upper case. Lower case phrases describe the 
type of Information to be supplied. "Line-range" Indicates the same 
type of numbers as with the Basic LIST command: 300-400 , 500-, -900, 
and - are all valid line ranges. 

AUTO (IIne-number (.Increment) ) 

The AUTO command puts the 64 Into automatic line numbering entry mode. 
Each time RETURN Is pressed, the machine will prompt with the next line 
number. This allows easy entry of Basic text. If a line-number ts 
provided, the 64 will begin by prompting with this number. Each 
subsequent number will be a value of "Increment" higher than the 
previous line. The Increment value may range from 1 to 255. If no 
Increment Is provided, the last known Increment will be used; Its 
Initial value Is 10. 

If no arguments are supplied, POWER 64 will search through the current 
Baste program for the last line number. It will then prompt with a 
number which ts the Increment value higher than this. This feature can 
be used to append lines to a program. 

During entry, pressing RETURN will cause the next line prompt to be 
given. If RETURN Is pressed Immediately after a line Is prompted (t.e., 
before any other key), auto line numbering will be turned off. The 
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RETURN character will be changed to a Shifted RETURN so that the line 
whose number was displayed will not be deleted, 

DEL 11ne-ranqe 

This command deletes a block of lines from the current Baste program. 
Giving a null line-range produces an error rather than deleting the 
entire program. 

DUMP 


This command causes a list of all 64 variables and defined functions to 
be listed. Variables will be printed with the following format: 

"variable-name" = "value" 

The user may change the value and press RETURN to cause the variable to 
be changed. 

Functions which have been defined by executing a DEF FN... statement 
will be shown. 

FIX 

The FIX command re-Inltlaltzes the POWER 64 package. Some Internal 
pointers are restored. The end of the current Basic program Is found 
and Internal Basic pointers are set to match this location. Using FIX 
will destroy all Basic variables. 

FIX Is valuable If a bad program or a non-standard LOAD has upset some 
of the Internal pointers used by POWER 64 or Basic, or If the second 
cassette buffer has been used for tape or other operations. 
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PTR 

PTR resets Baste pointers like FIX but does not reset POWER 64 Itself. 
It can be used after a non-Basic load. 

OFF 

The OFF command disables the POWER 64 package, restoring normal 64 
operation. Notably, the 64 Baste link vectors In three page are 
restored to the states they had before POWER 64 was called. Once you 
have turned POWER 64 OFF you can re-enable It with a command of SYS 704. 

RENUM 


The renumber command will resequence line numbers In a program. Line 
numbers will be changed according to specified rules. All line number 
references In GOTO, GOSUB, IF .. THEN, IF .. GOTO, ON .. GOTO, ON .. 
GOSUB and RUN statements will be changed. To support the Instant 
subroutine feature, line numbers appearing after the left-arrow 
character will also be changed. 

Renumber allows any portion of the program to be renumbered to any line 
range, provided no overlap occurs as a result. The line range, If 
provided, specifies what section of the program Is to be renumbered; If 
not provided, the whole program Is renumbered. The first line In the 
specified range will be renumbered to the value given In "new-start". 
Each line within the range will be renumbered, with each line htgher 
than the last by the Increment value. An error notice Is given If the 
renumbered line range conflicts with the sequence of other lines outside 
the range. 

During renumbering, parts of the program must be moved to make way for 
larger line numbers. In the unlikely case that such expansion causes 
memory to be filled, an OUT OF MEMORY error will result, and the Baste 
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program may be Irretrievably damaged. The user should try to avoid this 
problem by refraining from renumbering programs which are very close the 
the memory limit of his machine. 

"New-start" designates the Itne number to be given to the first 
renumbered line. If It Is left out, the Increment value will be used. 

The Increment value gives the spacing between renumbered lines. If It 
Is left out, a value of ten will be used. Thus a REN command with no 
arguments will renumber the entire program by Increments of ten, 
starting at Itne ten. 

SEL option-string (additional option-strings) 

The SEL command allows setting or disabling of user features. Up to 
four features can be modified: 

K - keyword expansion; enables expansion of keywords from shifted 
keys; 

R - macro expansion; enables Instant phrases and Instant 

subroutines; 

P - metacharacters; enables special characters for search/replace; 

I - Input; enables Instant keys during program runs. 

The sign may be + to enable the selected feature, or - to disable the 
feature. Normally, features P and R are enabled at startup and features 
K and I are disabled. 

Several option-strings can be specified within a SEL command: for 
example, SEL K- R+ Is acceptable. 
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TRACE (options) (») 


TRACE enables Trace features. The option ♦ Indicates that trace 
output ts to be written to a special group of Inverted lines at the top 
of the screen. It It Is not provided, trace output goes out normal 
vectors, and thus may be redirected by means of a CMD. TRACE STOP 
disables the trace feature. 

Full trace Is the default. This tmpltes output of the listed line and 
the result of the operation tor every line that Is executed. Option 
LIST generates the line listing only, while option # causes line numbers 
only to be output. Lines are listed starting with the currently 
executing statement. If the first part of a line has already been 
executed. It will not be displayed. Line numbers are output In one of 
two formats when displayed alone; they are printed separated by colons 
(;) without carriage returns. In T mode, the last ten Itne numbers to 
be executed are scrolled In the top 80 positions of screen memory. 

Variable output Is provided beneath the listing of the executed Itne. 
Results are preceded by an equals sign (=). String results will be 
preceded by a quote, and will be truncated to screen width. These 
values are obtained by examining 64 Internal memory locations at the 
termination of a statement. It Is not always possible to have a 
meaningful value available. NEXT statements without a variable may 
generate an tncorrect value. Only one result can be output per line, 
even though some statements compute several values during execution. 
(POKE, PRINT) 

Tracing is controlled by three keys on the keyboard. If the "f5" key Is 
held down, tractng will continue at full speed. Pressing the equals 
"f7" key once will cause one line to be executed; this Is known as 
single-stepping. Holding down the Commodore symbol key will cause the 
program to execute normally (no tracing) while the key ts held down. If 
the program Is In a GET loop and needs Input, you may type In your 
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Input, and then hold down the "f5" key or Commodore key until It has 
been read. 

Tracing Is turned of via the TRACE STOP command. Tracing remains In 
effect with Its current options until changed or turned off by command 
or by the program. Tracing can be enabled, disabled or changed within a 
program by means of a SYS command. A vector In three page provides this 
feature. The user may code a program command of the form: 

TR = PEEK(705)t256*PEEK(706)-3 
SYS TR,I"traceIetters"1 

to change trace operation. SYS 7R,ST0P will disable tracing, while SYS 
TR,#^ will enable number tracing at the top of the screen. A simple 
SYS TR, will enable full tracing with normal output. 

WHY 

The WHY command Is a debugging aid. It may be executed tmmedlately 
after program execution Is halted by an error or Intentional means. If 
done at this point, the WHY command will list the Itne that was being 
executed at the time of the Interruption with the block where the Baste 
memory scan pointer was printed- In reverse field. This only Indicates 
where the Baste scanner stopped, which Is not always a perfect 
Indication of the source of an error. If other commands are executed 
before the WHY command Is done, the Information It needs may be 
destroyed, tn which case It will list nothing. 

EXEC flienumber 


The EXEC execute command executes lines from a Commdore 64 sequential 
file (disk or tape) as though they were typed from the keyboard. Each 
line Is read from the designated file and placed In the Basic Input 
buffer. Line-feed characters are Ignored. Lines are printed on the 
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screen as they are received. Once the line Is read In, control Is 
passed to the 64 so that It can be processed. At end of file, the file 
ts closed, and control ts returned to the user. 

To use EXEC, first open the file to be executed In the normal way (an 
OPEN statement). The ft le number used In the OPEN statement Is then 
passed to EXEC on Its command line; a variable or expression may be used 
to define the file number If desired. The ftle may contain a listing of 
a program In which case that program will be merged with the current 
one. A RUN statement may also be Included on the file; this would 
start the current program. Operation of EXEC can be halted with the 
STOP key. 

/ (pattern) (/llnerange) 

The search command allows the user to scan through Basic program text 
for a desired string. The search argument ts provided as a "pattern", 
which will be searched for In one of two ways: 

A) All occurences In the specified line range will be printed If 
the "/ llnerange" sequence follows the command, or 

B) The next occurence of the pattern will be printed. 

A current-line pointer ts maintained by POWER 64 and ts used by the 
scrolling feature, the AUTO command and the Search and Replace commands. 
If the next occurence of a pattern Is desired, the search will proceed 
forward, starting after the current line, wrapping around the end of the 
program to the beginning and continuing until the current line Is 
reached. This feature allows the POWER 64 user to search through a 
program, listing occurences of a given pattern one at a time. 
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A pattern ts used to specify the string to be searched for. Normally It 
Is the Baste text that the user desires; for example, to find all 
occurences of NEXTX In a Baste program, one would type: 

/NEXTX/ 

The pattern may also contain what are referred to as "meta-characters", 
which are pattern-matching characters with special meanings. The dot 
character (.) will match any character or token In Basic text. For 
example, /A.B/ would find all cases of strings such as AAB ABB ACB A$B 
etc. The dot will also match any tnternal Basic token, since the search 
ts done byte by byte. Thus the above would also match cases of ATOB, 
ATHENB etc. 

As the dot matches any arbitrary character or token, the star (») will 
match any arbitrary string on a given Itne. For example, the pattern 
FOR*NEXT would find all cases of a FOR which Is followed by a NEXT on 
the same Itne. Similarly FOR*TO*STEP would ftnd all FOR statements with 
STEP modttiers, no matter what variables or other conditions are In the 
statement. The star matches the shortest possible arbitrary string, so 
to match the beginning of a line. It Is necessary to use dot star (.*), 
whtch will match any character (the first) followed by an arbitrary 
string. 

The end of the line (not the last character) may also be matched with 
the close bracket (1) character. This ts generally of use during 
substitutions (see Replace command) but can be used In searches. The 
pattern NEXTX) will find all lines ending In NEXTX. The *1 pattern will 
match the remainder of a given line. (It Is assumed some characters 
preceed this pattern, since *1 alone will match all lines.) 

The pattern argument of the Search command ts optional. Should It be 
left out, the pattern given In the last Search or Replace command will 
be used. This allows convenient searching for further occurences of an 


Page 76 



POWER 64 Manual 


APPENDIX C: DESCRIPTION 


already typed pattern. For example, just typing the '/' command alone 
on a line will cause a search for the next occurence of the Iast pattern 
used. This allows the user to go through occurences of a pattern, one 
by one, with just a two keystroke (/,RETURN) sequence being required to 
list the next occurence. 


Replace command 

S/ (search pattern) / (replacementstring) (/ "Ilnerange") 

The replace command will take the given pattern and replace It with the 
replacement string at all occurences In the given line range. If the 
terminating / symbol and line range are omitted. It will work on the 
same line by line basis as Search. As In Search, the pattern may be 
omitted, which will cause the last pattern to be used. The escape 
character may be used In the replacement string to avoid tokenlzatton 
and to Include a / symbol. 

Replace operation Is very similar to Search operation. Each line 
changed Is listed on the screen after It (s changed. Replace action 
over a line range can be aborted with the STOP key. 
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INSTANT ACTION FEATURES 


POWER 64 provides many Instant action features. They are detailed below 
Basic Program Scrolling 

POWER 64 provides the ability to scroll back and forth through a Baste 
program In full screen editor style. To do this, a special 
Interpretation ts given to cursor up charactrers typed on the top line 
of the screen and cursor down characters on the bottom. When cursor 
down Is typed on the bottom, POWER 64 reads screen memory to find the 
line number of the last line on the screen. To do this. It looks at the 
first two characters of every logical screen line, going upwards from 
the bottom. If It ftnds a number starting In such a place. It reads It 
using standard Basic number reading routines. It then finds the next 
line In the Basic program and prints It at the bottom. 

Cursor up characters have a similar effect. When one Is typed, POWER 64 
searches forward from the first character on the screen for a Itne 
number. If It ftnds one. It searches the program for the previous line 
and 11 sts 11 at the top of the screen. The text on the screen l s moved 
down one or two lines to accomodate for the new line being listed. 
There may be some problem with lines longer than 80 characters, but 
POWER 64 handles most contingencies. Blank lines are rarely left on the 
screen, and lines longer than 40 characters are not left truncated on 40 
column machines. 

It should be noted that since scrolling from the bottom searches the 
first two characters of each Itne, user typed lines will be found as 
well as lines listed In the conventional manner. It Is possible with 
POWER 64 to type a number at the bottom of the screen, cursor down and 
see the Itnes following It. This Is usually quicker than a LIST command 
for the same Itnes. 
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REM MACROS (Instant Phrases and Subroutines) 


POWER 64 provides the facility to redefine keys by means of special REM 
statements. A key can be defined to print a string or call a Basic 
subroutine. When any key ts pressed, a search Is done through 
statements at the beginning of the program. The search Is terminated If 
a definition for the key pressed Is found, or If some statement that ts 
not a key defining statement Is found. A defining statement which 
causes a string to be printed Is of the form: 

1Orem"P=Power 

which will cause the shifted P to print the word Power on the screen. 
The quote allows graphic characters and cursor movements to be Included 
In the string, which means that graphic pictures can be generated with a 
single key. 

If a definition statement Is of the form 
12REM"T<100 

100?"the time Is ”;TI$:RETURN 

It will define the shifted T so that It calls the subroutine at line 
100, which In this case prints out the time of day variable. Uses for 
this feature are unlimited, and are detailed In the tutorial section of 
this manual. 

REM macros can be disabled by means of the SELR- command, and re-enabled 
by means of the SELR+ command. 
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Instant Keywords 

When Instant keywords have been enable by SELK+, pressing a shifted key 
will cause a keyword to be printed on the screen. This will not happen 
If a REM macro Is defined for that key. The keywords are associated In 
a loose manner with the letters that call them. Refer to Appendix F for 
details of the mappings. The keyword expansion feature can be enabled 
and disabled with SELK+ and SELK- respectively. The keyword Is printed 
by a POWER 64 routine called PRKWRD. See the machine language Interface 
section' for details on that. 
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APPENDIX D: Machine language Interfaces. 


General Information. 


POWER 64 must co-ex 1st with the Internal 64 operating system. It 
Interacts with and makes heavy use of built-in ROM routines. The 
methods used lead to some considerations that machine level programmers 
should know about. POWER 64 provides facilities for expansion and 
compatibility with other packages; this Is documented here. 

The Commodore 64 ROM Basic provides special vectors to allow programs 
like POWER 64 to alter the characteristics of Basic operation. POWER 64 
makes use of four of these vectors In normal operation. Realizing that 
other programs may wtsh to make use of these vectors as well, POWER 64 
does not destroy them. Rather, before altering them It saves the old 
contents away, and where tt would use the routines these vectors point 
to. It uses the saved values. It should thus be possible to use 
POWER 64 with other programs that make use of these vectors, as long as 
POWER 64 Is called Into being after these programs are, or If these 
programs are as courteous as POWER 64 In their use of the vectors. 

The four vectors used are known as the character INPUT vector, the 
character OUTPUT vector, the WARMSTART vector and the EXECUTE vector. 
All others are left untouched. 

POWER 64 adds commands by Intercepting the EXECUTE vector, which Is 
passed through efore every statement Is executed. The WARMSTART vector 
keeps POWER 64 going and helps the WHY command. The tnstant action 
features are all provided by means of the INPUT vector. 
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The Keyboard Map Table 

Several of the Instant action features of POWER 64 are controlled by the 
Keyboard Map Table. Whenever a key Is pressed, POWER 64 searches this 
table to see If It has an entry tor what to do with this key, provided 
keyword expansion Is enabled. There Is a table Inside POWER 64 that 
maps the Instant keywords that come with the system, but POWER 64 allows 
for the user to add his own table that will be scanned before the one 
Inside POWER 64. To add your own table, you must alter a special vector 
In POWER 64's page two memory block. It Is called USRDEX. To have your 
own table, place the address of It In the two byte vector USRDEX. Your 
table can be up to 255 bytes long. To tell POWER 64 you have a table 
for It to scan, you must put the correct value In a check byte called 
USRDEXCK. To calculate this byte, add the two bytes of your new USRDEX 
vector together and exclusive or the sum with hex value $A5. Store this 
result In USRDEXCK and POWER 64 will scan your table. 

Table entries are two or four bytes long. The first byte In any entry 
Is the character being defined. If this byte ts zero, this signals the 
end of the table. Otherwise It defines a character. The second byte 
says what to do with the character. If It ts zero, that means to stop 
the scan Immediately and do nothing with this character. Through this, 
you can stop expansion to keywords done tn the second table. 

If the second byte ts negative, (high bit set) It Is taken to be a Basic 
token number, and the keyword coorespondIng to that token wtll be 
printed. If It Is a function token, an open parenthesis will be printed 
after the keyword. 

If the second byte ts one, the next two bytes tn the table are 
considered a subroutine address. The subroutine at that address will be 
called. If It exits with carry set, the character In the accumulator 
will be passed back to POWER 64 to be treated as though It had been 
typed. If carry Is clear, the accumulator will be Ignored. 
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If the byte Is a two, the next two bytes are treated as a pointer to a 
string. This string will be printed up to the first zero byte. The 
last character In the string before the zero byte will be treated as 
though It were typed, so If It Is a RETURN character you can get this 
key to cause action. 

All other second bytes are undefined. 

MOREPOWER creates Its own Keyboard Map Table, and lets you work In It 
with the KEY command. If a table already exists. It will work with 
that one Instead. 

POWER 64 uses memory. Zero page storage ts used only temporarily; 
permanent storage ts kept In page two of 64 memory. In general, the 
Information there Is not overy sensitive, so they may be overwritten 
without crashing POWER 64. Overwriting these bytes will, however, cause 
some options and default parameters to change In unpredictable ways. 
This storage area Is from $2C0 to $2E0, and the locations themselves 
that are of Interest are given tn the memory map below. 

Adding commands to POWER 64. 

POWER 64 provides a facility for adding extra commands to the thirteen 
already provided. This Is done through a vector In the page two area. 
POWER 64's control of the command scan takes place after the Itne has 
been tokentzed. This means that If you wish to recognize additional 
commands, you will have to do so with a tokenlzed line. (Watch out 
here! For example. If the command contains the letters "TO", you will 
have to check for $A4 Instead of a "T" and a "0".) There Is a three 
byte vector consisting of the byte UCVCHK ($02D2) and the Indirect jump 
vector UCOMVEC (S02D3). Before command scanning Is done, POWER 64 
checks to see If a valid vector Is present for added commands. To do 
this It adds (carry clear) the two bytes tn UCOMVEC. The result Is then 
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exclusive or'd with the value $A5. (binary 10100101) This Is compared 
with the check byte UCVCHK. If they match, an Indirect jump Is done 
through UC0MVEC to the user routine waiting there. Note that this jump 
Is done before normal POWER 64 command scanning occurs, so the user may 
redefine POWER 64 commands. 

The user routine may scan for commands In the Basic Input Buffer ($200) 
In any way It wishes. If It does NOT find any command It wishes to 
Interpret, It should return control to POWER 64 and Basic. To do this, 
a JMP should be made through the vector N0RMC0M. If the user does find 
a command, POWER 64 will help him call It. First, the user routine 
should alter the Basic execution pointer ($7A-$7B) to point to the last 
byte In the text of the recognized command In the Basic Input buffer. 
Then, tt ADDR Is the address of the routine to execute the command, the 
user should load the low byte of ADDR-1 Into the Y register and the high 
byte of ADDR-1 Into the X register. A JMP should then be made to 
ENTCMD. Thts will start the user command executing In the normal 
Baslc-POWER environment. In this environment, Basic and POWER 64 
routines may be called to scan the command line and evaluate 
expressions. CHR6ET may be used to get subsequent bytes, and a simple 
RTS wtl I terminate the command and allow Basic to pick up as usual. 
When the command Is Invoked, the first byte following the command on the 
command line will be In the accumulator, as Is usual for a Baste 
statement. 

The vectors ENTCMD and NORMCOM noted above move about tn memory 
depending on where POWER 64 Is located. To call them, you will have to 
but Id Indirect jump vectors for them. This Is explained In the section 
of POWER 64 routine addresses, and the example program for adding 
commands to POWER 64 that comes with this document shows how to do this. 

When adding new commands. It Is a good Idea to allow them to ’chain’. 
This means that several new commands can be added Independently. This 
can be done In the following way: 
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When new commands are being added. It will be necessary to alter UCOMVEC 
and UCVCHK. Before this Is done, the user code should check to see If 
they already contain valid entries (le, somebody else Is already there). 
If this Is the case, the user should save the old vector In a private 
place. When the time comes to JMP to NORMCOM If a command Is not found. 
It should Instead jump to this vector. The user can also make It easy 
by always jumping through this vector, and putting NORMCOM there If 
there Is nothing valid In UCOMVEC. Naturally, the user may wish to put 
check bytes on the vectors he saves away. 

The sample program to do all this Is on your POWER 64 program disk under 
the name ADDCOMS.PAL. This program adds one sample command to POWER 64 
called NAME, which simply prints a string. 


POWER Entry Point Vectors 


There are several useful vectors at the front of POWER 64. Already 
documented In the main manual Is USRINV which allows the user to control 
tracing from within a program. 

The difficulty Is using these vectors Is that they move about In memory 
as POWER 64 Is relocated. In order to call these vectors, which are 
found at the start of POWER 64 memory, you must create Indirect JMP 
vectors based on your calculations of where they are. 

At location 704 decimal or $2C0 hexadecimal, POWER 64 stores a 3 byte 
JMP Instruction to start It up again after an OFF. The address In this 
JMP Is just after the entry point vectors. You can calculate your own 
JMPs for POWER 64 vectors by taking the value at $2C1-$2C2 and 
subtracting the amount shown below from It. In the listings below, the 
value at S2C1-2 will be represented by the symbol "POWER". 
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USRINV (POWER - 3) Is, as documented before, the place to call from 
Baste to change TRACE parameters, 

NORMCOM (POWER - 6) Is the location to jump to after scanning the 
command line when adding extra commands to POWER 64 If you decide that 
you haven't found one of your own commands, 

ENTCMD (POWER - 9) Is the jump location to call your own extra command 
once you have found It. It's use, with NORMCOM Is documente above. 

POWER 64 has the ability to make substitutions In Basic text. This Is 
provided as a subroutine for the more adventurous programmer. Before 
REPL (POWER - 12) Is called, the following should be set up: 

POINTR ($7A) - pointer to ftrst byte beyond string to be 
rep Iaced 

LINPTR ($5F) - pointer to start of string to be replaced 

NEWLEN ($9B) - length of replacement string 

NEWBUF ($120) - replacement string starts here 

REPL fixes all Internal Basic chain and end pointers. An OUT OF MEMORY 
ERROR can result If there Is not enough space left. 

JSR DORANG (POWER - 15) will read tn a line range from the Basic Input 
stream. This ts handy If you are defining new commands. Once called, a 
pointer to the ftrst Itne tn the range will be In LINPTR ($5F) and the 
number of the last line will be In INTADR ($14). 

A JSR WRP (POWER - 18) will correct the Basic Itnk chain and alter the 
end of Basic potnters In zero page to potnt to the real end. 
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JSR DELEN2 (POWER - 21) Is the memory mover (downwards) used by REPL. 
The low address (start of destination block) Is kept In LINPTR ($5F) and 
the start of the moved block should be In TP1 ($58). Memory up to the 
end of Basic text Is moved ($20). 

The routine INGOCALL (POWER - 24) can be used to call Baste subroutines 
from machine language programs. LINPTR <$5F) should contain a pointer 
to the first line In the subroutine. This would be set up by a call to 
the Basic routine FINDLINE ($A613) with the line number In INTADR ($14). 
The Baste subroutine will be called, and when tt RETURNS, It will come 
back to your machine language code. This Is tricky, however, as the 
Basic routine could have side effects that could cause havoc for your 
program. 

Routine LSTLIN (POWER - 27) lists a program line through POWER 64's 
output subroutine. Thts normally points to the normal 64 output 
routtne. A pointer to the start of the line should be tn LINPTR <$5F). 
This pointer should point at the link bytes preceding the line. 

PRLNO (POWER - 30) Is a handy routine to print the line number found In 
LN0L0 ($3B) out the standard Input vector. 

PRKWRD will print a keyword from the POWER 64 keyword table. The Index 
number of the keyword In the table should be In the X register when the 
routine Is called. The keyword table format Is the same as that used by 
the 64. If the X register contatns $FF, the symbol PI will be printed. 
Keyword numbers range from $80-$FE. This routtne Is special. In that It 
Is not In the normal vector area. It*s address can be found at location 
KEYWLINK ($2CB), and a JMP Indirect through there will transfer to ft. 
Note that programs that add extra keywords to the 64 should change this 
vector to a routine that understands the new tokens If they want 
POWER 64 to deal with them. 
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POWER; Memory Map 

The only permanent storage used by POWER 64 Is In page 2. 

Locations of Interest or use to you are given below. 

CALLVEC (S2C0-3) - Three byte vector giving startup address for 

POWER 64. Also of use for locating POWER 64 routine vectors. 

WARMLSAV (S2C3-4) - Storage for old WARMSTART link vector. 

RUNLSAV ($205-6) - Storage for old EXECUTE link vector. 

INLSAV (S2C7-8) - Storage for old INPUT link vector. 

KEYWLINK (S2CB-C) - Special vector that POWER 64 jumps through to print 
keywords. Should be altered to new routine by any program that adds 
keyword tokens to 64 Basic. 

TEMSA (S2CE) - This location Is used by the EXEC command to store the 
secondary address of the file being read. It Is restored after every 
line pulled In by the EXEC command, since It Is possible that EXEC lines 
wt11 close ftles. 

TEMDEV ($2CF) - Thts location stores the device of the file used In the 
EXEC command. 

OUTLSAV (S2C9-A) - These locations are where the 64's OUTPUT vector Is 
saved when POWER 64 changes tt. 

AUTFLAG ($2E0) - Thts flag Indicates whether AUTO line numbering mode Is 
In effect. It Is nonzero If yes, zero otherwise. 
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UCOMVEC ($203-4) - This Is another Indirect JMP vector. ’ It Is'ljs.ad for 
adding commands to POWER 64, and a detailed description of this Is given 
In the section on that topic. 

UCVCHK ($202) - This Is the check byte for UCOMVEC. See the section on 
adding commands to POWER 64 for details. 

WHYCNT ($2D5) - This ts a special counter used by the WHY command to 
Indicate how far Into the line Basic was when It stopped. 

WHYPTR ($200-1) - This Is the actual pointer Into the Basic text where 
Basic stopped scanning, used by WHY. 

REMFLAG ($206) - This flag Indicates whether REM macro expansion Is on. 
Negative for on, zero for off. 

USRDEX ($2D9-A) - This points to the Keyboard Map Table If the user sets 
one up. 

USRDEXCK <$2D8) - Check byte for USRDEX. 

0PTFLAG ($2DB) - General option flag for K and P options of SEL. 
Keyword expansion Is ON when this Is negative, OFF when positive. 
Metacharacters are not given special meanings If bit 6 Is on, they are 
If It Is off. 

AUTINC ($200 - Current AUTO Increment. 

CURSOR ($200) - Output cursor for reversed trace output. 

TFLAG ($2DE) - Flag that controls trace mode. Zero for Trace off. Odd 
If tracing Is to be at top (bit 0=1). Bit 6 on for a Numbers trace, bit 
5 on for a Listing trace, and bit 7 on for a full trace. 

INPUTFLG ($207) - Flag for SEL I option. 
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APPENDIX E: Anomalies of the POWER 64 system. 


Thef-e 1 are certain things that happen with the POWER 64 system that seem 
oddv : " They are not errors or oversights - just odd things that happen 
under certain circumstances. 

MSny of these happenings are a result of the 64's Internal workings. 
POWER 64 taps Into the 64's mechanisms - and some of these aren't able 
to react to every possible combination of program and command. 

Don't get upset If some of the occurences listed below happen to you. 
They'are normal, and don't mean that POWER 64 Is malfunctioning. 

Search oddtties 

Keywords such as LOAD or REM can occasionally be confused with cursor 
movements such as CLEAR and HOME. They are stored tn a similar manner 
within the computer, and POWER 64 sometimes has trouble telltng them 
apart. 

Instant features lost on RESET 

You will find your POWER 64 Instant features gone If you rese^ the 
machtne wtth the STOP and RESTORE keys. Use FIX to get them back. 

Scro111ng anomaIy 

If a Baste line exceeds 80 characters In length, the listed line will 
"spill over" Into the next Itne. If the overrun happens to be a number, 
POWER 64 will confuse It with a legitimate line number and will not 
scroll properly to the next line. 
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If the cursor ts not at the left of the screen when scrolling takes 
place, the first line printed will not start at the beginning of the 
I Ine. 

Also note that If POWER 64 finds a number on the screen that Is not. a 
valid line number, scrolling the screen with the cursor-up. or 
cursor-down key will cause the computer to print "SYNTAX ERROR." Not-to 
worry, once this Illegal number (which POWER 64 percetves as a line 
number) Is gone, the error will go away, and POWER 64 will scroll ,your 
program from the beginning. 

Conflicts with programs 

Programs which use the page two area of memory that POWER 64 uses for 
storage may conflict with the POWER 64 system. 

Programs or systems making use of the same link vectors to create new 
Basic commands are likely to conflict with POWER 64 unless they are 
called before POWER 64 or are as courteous as POWER 64 In using, these 
links. If posstble, the POWER 64 "hooks" should be used to allow the 
programs to exist together. 

Programs with machine language portions should not be used with POWER 64 
unless care Is taken to ensure that pointers or programs are not harmed. 
POWER 64 Is Intended primarily for Basic support: It may not know of 
special requirements of the machine language systems. Experienced 
programmers may use PTR to good advantage, restoring vital pointers as 
necessary before running or saving. . 

Renumbering 

If the Baste program should contain a line number reference of 64000 or 
greater, renumbering will not take place correctly and the machine w!11 
report 7SYNTAX ERROR. The Basic program will likely be harmed and the 
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user should not attempt to continue using It. This Should be a rare 
occurence, since you cannot have .Baste lines numbered 64000 or over; It 
would be most unusual to code GOTO 64000. 

On rare occasions, renumbering a program to higher line numbers might 
causes It- to require more-memory than Is available In the system. If 
this should happen, an ?0UT OF MEMORY error will be generated, and the 
program will be Irretrievably damaged. 

v ... 5 
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. . - ... . ;, .. -tf ,y 

This table shows what tnstant keywords you.get from various - keys' ■When 
keyword expansion Is enabled with POWER 64. i.,c i !i 

*f!r> ' * . 

Keys are listed below with what keyword they produce. To get a keyword, 
you must press the given letter along with either the Shift (SH), 
Control (CTL) or Commodore symbol (CBM) key. 


Key 


Keyword 

SH 

A 

ASC< 

SH 

C 

CLOSE 

SH 

F 

FOR 

SH 

6 

GOSUB 

CBM 

6 

GOTO 

SH 

1 

INPUT 

SH 

L 

LIST 

CBM 

L 

LEFTS( 

SH 

N 

NEXT 

SH 

0 

OPEN 

SH 

P 

PEEKl 

CBM 

P 

PRINT# 

CTL 

P 

POKE 

SH 

R 

RETURN 

CBM 

R 

R1GHTS( 

SH 

S 

SAVE 

SH 

T 

THEN 

"f 1* 
RUN 

i 

LOAD 

RUN<return> 
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APPENDIX G: A Sample Basic Programs ’ ~ -■ 


Here's a sample program you can use to try out y&ur skills on the 

POWER 64 system. It Is a simple program to find prime numbers within a 
given range. 

: ms•• •• •• * ' y , %..■“? A „ A'-' 

100 print"prime number finder" 

- ,e? • ’ HO prInt"*f3ftd'primes from"; *’"* ' ' J 

120 gosub 330 s - Tr e ' 

130 f=v 

•vet v<:C: M0 ! (jrlnf^upWr ’ _ '~ L ' : 

150 gosub 330 ~ r,< “ 1 :i 

160 t=v . 

170 f1=f' lW - ,i; 1T • ' "•*»* ■« ■' 

180 If t<? goto 300 

i£?ei r ^Q t f ^_2 then j =2:gosub 370 .-.-.a sr ’ 

200 If t<3 goto 300 
210 If f<=3 then j=3:gosub 370;f1=4 
'’n-r.** 220 f2=fht<f1/27*2tr ' 

230 If f2>t goto300 ' r ' 

240 for j=f2 to t step 2 
’ " 250 for k=*!5 to SqrljH'.OI : ■ '-e-i.--e 

260 x=j/k 

270 If x=Int(x) goto 290 v ? 

280 next k:gosub 370 
r '“ r,! ' p • 290 next j ’ 9 r 

* 300 print Sprint n;"pr‘fmes fbund'from";t;"to";t • 

310 stop 

' " " ' ' *320‘prVnt"--'try'afio+her’’numBer*";' 1 T ' c •' 

*.<icw ; i B 330 , ''ln^tit v e " c ' ' ri? ■ ; T ' q*?r 

340 If v>1e9 then prtnftoo h!gh";:goto 320 
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350 If v<f then prtnf'+oo low";:goto 320 
360 return •*,*. 

370 print j; 

380 n=n+1 

. t -390 return •, • , ;<A . 

„r 

Here are a few exercises you might like to try with this program: 


'"’Sj ' rffT. ~ C ’’ 

1. Enter the program using Auto Line numbering.. , If, you• like, use 

Instant Keywords. 0; L 

2. The program Is too big to fit on the screen..,. Scrol l^ep and down 

and look at the various parts of ft. ( .»i Or. 

06 ' 

3. Run the program and dump the variables with DUMP* = . ’ 

T ? C 7 £ ' • * f 

4. Renumber the program so that It starts, at Jjpe ,10 and goes In 

steps of 10. ,j,v • . T r . jd 

5. Now find the new line numbers for tbe-two subroutines^' Searching 

for GOSUB should do the trick. ~ rc 

6. Renumber the subroutines only so thpt'tjiey.start at. line 500. 

7. Change variable t2 to m2. -1 

C r * ’I 1.»-• c V * • „• ' -o r 

8. Change SQR to SQT. This will cause an error, of course. Run the 
program, and when. It-,stops, ,ask: , ,WHY? Then, fix the problem. 

9. Set TRACE A and run the program.Qginlt forget,to -use ’the "f5 n 
or "f7" keys to step through the Instructions. -Watch ft all work. 

op: ■ ‘'Hpi-r ; .-j ■ ■ “ i ’ “iq £«■!•, '! 0-i 
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, KI« *■> Hobs? Find all occurences ot the 
,0 - out why It Is used that way. 

11. Try your own tests, ch 9 ng?s,, or„whatever. 
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WARRANTY DISCLAIMER 


All Pro-Line Software Ltd. computer programs, whether supplied on 
magnetic media such as but not limited to cassette tapes or diskettes or 
In any other form, any associated devices and any Instructions or 
manuals, are sold on an "as Is" basis wtthout a warranty of any kind 
expressed or Implied. Pro-Line Software Ltd. does not warrant the 
fitness of any program for any purpose nor does Pro-Line Software Ltd. 
warrant the accuracy, quality or freedom from errors of any programs,- 
devices. Instructions or manuals. 

Pro-Line Software Ltd., their distributors, agents and retailers 
assume no responsibility for any consequential. Incidental or other 
liability arising from the use, the Inability to use or the attempted 
use of any program nor for any lost profit or any lost savings however 
Incurred. 
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PLEASE PROVIDE THE FOLLOWING INFORMATION 


N? 14825 


NAME: _ 

ADDRESS:_ 

CITY: _ 

STATE/PROV.: _ 

ZIP CODE: _ 

PHONE:_ 

PLEASE CIRCLE ONE POWer 6 4 

CHEQUE, MASTERCARD, VISA, AMEX 
CARD NUMBER:_ 

EXPIRY DATE: _SIGNATURE: _ 











WE’LL BACK YOU UP! 

ONE BACK-UP COPY OF THIS PROGRAM IS 
AVAILABLE BY RETURNING THIS COUPON 
AND A CHEQUE, MASTER CARD, VISA OR 
AMERICAN EXPRESS NUMBER FOR $20.00 TO: 

PRO LINE SOFTWARE LTD. 

755 THE QUEENSWAY EAST, UNIT 8 
MISSISSAUGA, ONTARIO CANADA 
L4Y 4C5 


PLEASE SEE OVER 


HlO-USti SOfTAAHE 


LTD HSS5S5AUG* ONTARIO 



